Workspaces
List workspaces
Scope: the organization of the token workspace — every live workspace of that organization is reachable; one outside it is a 404. A token whose workspace has no organization only sees itself. Keyset-paginated with typed filters.
Create workspace
Requires a `src=system` token. The workspace is created inside the token organization. Scope: the organization of the token workspace — every live workspace of that organization is reachable; one outside it is a 404. A token whose workspace has no organization only sees itself.
Create or update workspace
Upsert. Takes the same body as POST plus the lookup keys `id` and `external_id`, matched in that order. A match is updated in place and returns 200 — fields absent from the body keep their stored value. No key, or no match, creates the workspace exactly as POST would and returns 201. Scope: the organization of the token workspace — every live workspace of that organization is reachable; one outside it is a 404. A token whose workspace has no organization only sees itself. Requires a `src=system` token; `external_id` cannot be changed on a matched workspace (409).
Get workspace
Accepts either the internal UUID or the resource `external_id`. Scope: the organization of the token workspace — every live workspace of that organization is reachable; one outside it is a 404. A token whose workspace has no organization only sees itself.
Update workspace
Accepts either the internal UUID or the resource `external_id`. Scope: the organization of the token workspace — every live workspace of that organization is reachable; one outside it is a 404. A token whose workspace has no organization only sees itself. Changing `monthly_cost_limit` / `monthly_emails_limit` requires a `src=system` token.
Delete workspace
Accepts either the internal UUID or the resource `external_id`. Scope: the organization of the token workspace — every live workspace of that organization is reachable; one outside it is a 404. A token whose workspace has no organization only sees itself. Requires a `src=system` token.