# List workspaces

> Every workspace you belong to.

**Source:** https://postprism.app/docs/api/list-workspaces  
**Updated:** 2026-10-10

---

`GET https://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

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

## Response

Status `200`.

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

| Field | Type | Description |
| --- | --- | --- |
| `id` | uuid | The workspace ID. |
| `name` | string | The workspace name. |
| `role` | string | Your role in it. One of: `owner`, `admin`, `editor`, `viewer`. |
| `is_active` | boolean | `true` for the workspace your API key (or MCP connection) acts on by default. |

```json
{
  "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

| Status | Message | When |
| --- | --- | --- |
| 401 | `Invalid or revoked API key` | The `Authorization` header is missing, malformed, or the key was revoked. |
| 429 | `Too many requests` | You went over the hourly limit. See Rate limits. |