List workspaces

Every workspace you belong to.

Last checked against the API October 10, 2026 · View as Markdown

GEThttps://studio.postprism.app/api/v1/workspaces

Returns every workspace you are a member of, with your role. Pass an id as workspace_id to the post, analytics and platform endpoints to act on that workspace, so one key can work for several brands or clients.

Example

List workspaces
curl "https://studio.postprism.app/api/v1/workspaces" \
  -H "Authorization: Bearer pp_live_your_api_key"

Response

200. data is an array of Workspace. A workspace you belong to.

iduuid

The workspace ID.

namestring

The workspace name.

rolestring

Your role in it. One of: owner, admin, editor, viewer.

is_activeboolean

true for the workspace your API key (or MCP connection) acts on by default.

200 response
{
  "data": [
    {
      "id": "7b2d4e6f-0000-4000-8000-00000000b001",
      "name": "Juniper Roasters",
      "role": "owner",
      "is_active": true
    },
    {
      "id": "7b2d4e6f-0000-4000-8000-00000000b002",
      "name": "Northfield Dental",
      "role": "editor",
      "is_active": false
    }
  ],
  "error": null
}

Errors

StatusMessageWhen
401Invalid or revoked API keyThe Authorization header is missing, malformed, or the key was revoked.
429Too many requestsYou went over the hourly limit. See Rate limits.
PreviousGet your workspaceNextLinkedIn