Move File
Renames a file or subtree within a workspace (metadata-only). overwrite controls replacing an existing destination.
Access: namespace OPERATOR or above (write); a workspace-scoped agent key may act only on the trees it was minted for
Authorization
BearerAuth A namespace-scoped API key (cpk_…) for machines, or a Xeonr Auth OIDC
token for humans. The key's namespace and role are pinned server-side.
In: header
Header Parameters
Define the version of the Connect protocol
Define the timeout, in ms
Request Body
application/json
1 <= length <= 1281 <= length <= 40961 <= length <= 4096validate:skip a bool has no bounds
Response Body
application/json
application/json
curl -X POST "https://containers.xeonr.io/containers.api.v1.WorkspaceService/MoveFile" \ -H "Connect-Protocol-Version: 1" \ -H "Connect-Timeout-Ms: 1000" \ -H "Content-Type: application/json" \ -d '{}'{
"info": {
"path": "string",
"size": "string",
"mode": 0,
"isDir": true,
"sha256": "string",
"mtimeUnix": "string",
"symlinkTarget": "string"
}
}{
"code": "not_found",
"message": "string",
"details": [
{
"type": "string",
"value": "string",
"debug": {}
}
]
}Make Directory POST
Creates a directory (parents = mkdir -p). An existing directory is returned as-is; an existing file is AlreadyExists; a missing parent without parents is NotFound. **Access:** namespace OPERATOR or above (write); a workspace-scoped agent key may act only on the trees it was minted for
Read File POST
Server stream of a file's bytes in 64 KiB frames from a workspace or snapshot, with offset/length for partial reads (length 0 = to EOF; an offset past EOF yields a single empty EOF frame). On a miss in a live workspace, flushes that one path out of a mounting sandbox and retries before returning NotFound. Exactly one of workspace_id / snapshot_id must be set. **Access:** namespace VIEWER or above (read); a workspace-scoped agent key may act only on the trees it was minted for