Clarify APIGet a workspace
Returns a single workspace as a JSON:API resource, including the WorkOS organization ID used to mint an access token for it.
API key authentication. Send your key in the Authorization header as: api-key <your-api-key>.
In: header
Path Parameters
The workspace slug — the {slug} segment of your Clarify workspace URL.
Response Body
application/json
curl -X GET "https://example.com/workspaces/string"{ "data": { "type": "workspace", "id": "3b9f6c2e-8d1a-4f5e-9c7b-2a4d6e8f0c13", "attributes": { "slug": "acme", "name": "Acme Corp", "organization_id": "org_01HXYZACMECORP0000000000", "created_at": "2026-01-15T09:30:00.000Z" } }}Create a workspace
Creates a workspace owned by the signed-in user and returns it as a JSON:API resource once it is ready to use. Requires a user access token sent as `Authorization: Bearer <token>`. Retrying after a failure resumes the unfinished workspace instead of creating a second one, and repeating a create with the same name within ten minutes returns that workspace with status 200 and `meta.existing` set.
List workspaces
Returns every workspace the signed-in user belongs to as a JSON:API list with `links` and `meta`, in one page. Requires a user access token sent as `Authorization: Bearer <token>`; an API key gets 401 because it belongs to one workspace.