Workspaces
Create, list, and delete the isolated, permissioned workspaces your agents read from. Each workspace is its own virtual filesystem.
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"