Skip to main content

List your workspaces

GET 
/workspaces

Returns every workspace the token's owner belongs to, most recently updated first. Use a returned uuid as the {workspace} segment of every workspace-scoped endpoint.

Start here when you do not know your workspace UUIDs: the dashboard shows them in the URL, but this endpoint is the programmatic way to discover them.

The list is not paginated and takes no query parameters. Workspaces the user is not a member of are never returned.

Each entry carries that user's own membership under pivot — the role that governs which endpoints the token may call in the workspace, and whether the user may approve posts there.

Full path: /api/workspaces, or /{corePath}/api/workspaces if your instance sets a core path.

Responses​

The workspaces the authenticated user belongs to.