Get all workspaces for the authenticated user
Returns every workspace the caller holds a membership in, each stamped with the caller's `roles` and the workspace's `capabilities`. Sort with the `sort` query parameter (deep-object style, e.g. `?sort[name]=1&sort[createdAt]=-1`). A `sort` object in the request body is still accepted as a deprecated alias for one release.
Returns every workspace the caller holds a membership in, each stamped with the caller's roles and the workspace's capabilities. Sort with the sort query parameter (deep-object style, e.g. ?sort[name]=1&sort[createdAt]=-1). A sort object in the request body is still accepted as a deprecated alias for one release.
OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.
In: header
Scope: workspaces:read
Query Parameters
Sort directions per field (1 ascending, -1 descending).
Response Body
application/json
application/json
curl -X GET "https://example.com/workspaces"[ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "slug": "string", "description": "string", "logo": "3c06f846-1ab1-40a9-8645-a19a9fdeae85", "icon": "bc9b3dc5-578a-4929-a13c-7d1a9725e2b0", "color": "string", "status": "active", "createdAt": 1678886400000, "updatedAt": 1678886400000, "roles": [ "workspaceOwner" ], "capabilities": [ "string" ], "settings": {} }]