Workspaces
Authorization
bearerAuth HTTP bearer credential in the Authorization header. Two planes share the
scheme, distinguished by prefix:
grp_sk_…— a management key: full control of the account (workspaces, files, token minting, audit export) plus the read tools.grp_at_…— a scoped read-only token: minted per workspace, it may call only the read tools (ls/find/cat/grep) and is rejected by every management route.
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/workspaces"{ "workspaces": [ { "name": "string", "version": 0, "createdAt": "string" } ]}Authorization
bearerAuth HTTP bearer credential in the Authorization header. Two planes share the
scheme, distinguished by prefix:
grp_sk_…— a management key: full control of the account (workspaces, files, token minting, audit export) plus the read tools.grp_at_…— a scoped read-only token: minted per workspace, it may call only the read tools (ls/find/cat/grep) and is rejected by every management route.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/workspaces" \ -H "Content-Type: application/json" \ -d '{ "name": "string" }'{ "name": "string"}Authorization
bearerAuth HTTP bearer credential in the Authorization header. Two planes share the
scheme, distinguished by prefix:
grp_sk_…— a management key: full control of the account (workspaces, files, token minting, audit export) plus the read tools.grp_at_…— a scoped read-only token: minted per workspace, it may call only the read tools (ls/find/cat/grep) and is rejected by every management route.
In: header
Path Parameters
Workspace name. Workspace name must be 1-64 lowercase letters, digits, hyphens, or underscores, starting and ending with a letter or digit.
^[a-z0-9](?:[a-z0-9_-]{0,62}[a-z0-9])?$Response Body
application/json
application/json
application/json
curl -X DELETE "https://example.com/v1/workspaces/string"