List workspace starter plans
Returns the exact folder, database, and page plans used by the built-in workspace starters so authenticated users can preview and approve their starting content before creating a workspace.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/workspace-starters"{ "data": [ { "id": "team", "name": "string", "description": "string", "plan": { "headline": "string", "nodes": [ { "type": "database", "ref": "string", "label": "string", "description": "string", "fields": [ { "key": "string", "label": "string", "kind": "text", "options": [ { "name": "string", "color": "string" } ], "relationRef": "string" } ], "records": [ { "title": "string", "data": { "property1": "string", "property2": "string" }, "content": [ "string" ] } ], "views": [ { "kind": "board", "label": "string" } ] } ] } } ]}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Set the caller's workspace choice for an OAuth client
Records which workspace an OAuth client should use for the caller, replacing any previous choice for that client. Naturally idempotent: the row is upserted per caller and client. The caller must be a member of the target workspace, otherwise the request is denied. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.
List the workspaces the caller belongs to
Returns every active workspace the authenticated user is a member of, each with the caller's role and effective permission set. Accepts a Clerk session or a `snoze_sk_` API key, and the result is derived from membership rows, so it never includes workspaces the caller cannot see.