DevelopersAPI referenceAuth & accountsWorkspaces
Org profile
Any member. Org plus member_count and team_count (no tools).
View as MarkdownAuthorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
id*string
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/workspaces/string"{ "workspace": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "slug": "string", "name": "string", "kind": "string", "avatar_url": "string", "role": "string", "permissions": [ "string" ], "member_count": 0, "team_count": 0 }}Create a team workspace
Any authenticated user. Slug auto-derived; caller becomes owner and the new workspace becomes their default. Returns 200 with a new workspace-scoped access token (workspace payload without tools here). A "General" team is created with the workspace and the caller becomes its lead. Everyone who joins later is enrolled in it automatically, so no member is ever left with an empty teams[] claim.
Update workspace settings
Team workspaces only; requires org.settings.manage (owner/admin). Success returns the GET shape. Slug collisions 409; empty effective patch 400.