Workspaces
A workspace is a container for bug reports, spaces, and team members within your organization.
Response fields
| Field | Type | Description |
|---|---|---|
id | string | Unique workspace ID |
name | string | Workspace name |
slug | string | null | URL-friendly slug |
createdAt | string | ISO 8601 timestamp |
updatedAt | string | ISO 8601 timestamp |
List workspaces
GET /v1/workspaces
Scope: workspaces:read
Returns all workspaces you have access to. WST tokens only see their scoped workspace.
| Parameter | Type | Description |
|---|---|---|
sort | string | Sort field (default: createdAt) |
order | string | asc or desc (default: desc) |
cursor | string | Pagination cursor |
limit | number | Results per page, 1–100 (default: 25) |
Get a workspace
GET /v1/workspaces/:id
Scope: workspaces:read
Create a workspace
POST /v1/workspaces
Scope: workspaces:write — PAT tokens only (WST cannot create workspaces)
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Workspace name (max 80 chars) |
description | string | No | Workspace description |
Update a workspace
PATCH /v1/workspaces/:id
Scope: workspaces:write — Requires ADMIN role on the workspace
| Field | Type | Description |
|---|---|---|
name | string | Updated name |
description | string | Updated description |