API SpecificationWorkspaces
CreateWorkspace
lifecycle
Authorization
BearerAuth AuthorizationBearer <token>
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
Connect-Protocol-Version*number
Define the version of the Connect protocol
Value in
1Connect-Timeout-Ms?number
Define the timeout, in ms
Request Body
application/json
namespace?string
fromSnapshotId?string
optional: fork/template a snapshot (metadata-only, instant)
label?string
[key: string]?never
Response Body
application/json
application/json
curl -X POST "https://containers.xeonr.io/containers.api.v1.WorkspaceService/CreateWorkspace" \ -H "Connect-Protocol-Version: 1" \ -H "Content-Type: application/json" \ -d '{}'{
"workspace": {
"workspaceId": "string",
"namespace": "string",
"totalBytes": 0,
"fileCount": 0,
"updatedAtUnix": 0,
"label": "string",
"revision": 0,
"ephemeral": true,
"ownerKind": "string",
"ownerId": "string"
}
}{
"code": "not_found",
"message": "string",
"details": [
{
"type": "string",
"value": "string",
"debug": {}
}
]
}