Workspaces

A workspace is the top-level container that holds projects and members. Each API token is scoped to a single workspace.

List workspaces

GET/v3/workspaces

Returns up to 100 workspaces accessible to the bearer token. Use cursor to paginate.

Query parameters

Name	Type	Description
`limit`	integer	1–100. Default: 50.
`cursor`	string	Opaque pagination token from previous response.
`archived`	boolean	Include archived workspaces. Default: false.

Response

{
  "data": [
    {
      "id": "ws_4kQp7nLm2",
      "name": "Acme Corp",
      "slug": "acme",
      "tier": "team",
      "created_at": "2025-08-14T09:22:01Z"
    }
  ],
  "next_cursor": null
}

Create a workspace

POST/v3/workspaces

Creates a new workspace. Requires workspace:write scope.

Delete a workspace

DELETE/v3/workspaces/{id}

Permanently deletes a workspace and all data associated with it. This action cannot be undone.