---
title: "List the caller's workspaces"
method: GET
path: "/v1/auth/workspaces"
tags: ["Auth"]
---

# List the caller's workspaces

`GET /v1/auth/workspaces`

The workspaces the presented credential can act in. For Clerk tokens: all workspaces (Clerk organizations) the authenticated user belongs to. For Monid API keys: exactly the key's bound workspace (an API key can only act in the workspace it was created in). Requires an authenticated user but NOT a selected workspace — use this to discover which workspace to select.

## Response `200`

The workspaces the credential can act in — the user's memberships for Clerk tokens, the single bound workspace for API keys

- WorkspaceListResponse
  - `workspaces` WorkspaceListItem[], required
    - `workspaceId` string, required — Workspace (Clerk organization) id.
    - `slug` string, nullable, required — Organization slug from Clerk. `null` when the organization has no slug.

## Other responses

- `401` — Unauthorized — missing or invalid credentials
- `403` — Forbidden — caller has no workspace or no access
- `500` — Internal server error

## Changes

- **2026-09-25** `5abada71ceae` — 39 warning
  - added the new `IDENTITY_ALREADY_LINKED` enum value to the `errorCode` response property for the response status `401`
  - added the new `IDENTITY_ALREADY_LINKED` enum value to the `errorCode` response property for the response status `403`
  - added the new `IDENTITY_ALREADY_LINKED` enum value to the `errorCode` response property for the response status `500`
  - added the new `IDENTITY_LINK_RATE_LIMITED` enum value to the `errorCode` response property for the response status `401`
  - …35 more
- **2026-09-23** `fadab791136c` — 3 warning
  - added the new `X402_UNBOUNDED_PRICE` enum value to the `errorCode` response property for the response status `401`
  - added the new `X402_UNBOUNDED_PRICE` enum value to the `errorCode` response property for the response status `403`
  - added the new `X402_UNBOUNDED_PRICE` enum value to the `errorCode` response property for the response status `500`
- **2026-09-11** `9874d9e34fcf` — 3 info
  - added the optional property `errorCode` to the response with the `401` status
  - added the optional property `errorCode` to the response with the `403` status
  - added the optional property `errorCode` to the response with the `500` status

[Change history](https://skmtc.dev/monid/apis/monid-api/changes/v1/auth/workspaces/get.md)

---

[API](https://skmtc.dev/monid/apis/monid-api.md) · [All operations](https://skmtc.dev/monid/apis/monid-api/llms.txt) · [OpenAPI document](https://skmtc.dev/monid/apis/monid-api/revisions/5abada71ceae?raw)