Auth

List the caller's workspaces

Changed on

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.

get/v1/auth/workspaces

Request

  • Base URL: https://api.monid.ai
  • URL: https://api.monid.ai/v1/auth/workspaces
  • Auth: HTTP bearer

Headers

X-Monid-Agent-Modelstring

Model driving the calling agent. Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

X-Monid-Agent-Harnessstring

Agent harness or client making the call (e.g. a coding agent, an agent framework). Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

X-Monid-Agent-Session-Idstring

Caller-side session identifier, so the calls of one agent session (discover → inspect → run → polling) can be correlated. Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

Response

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

Example response

{
  "workspaces": [
    {
      "workspaceId": "org_2abcDEFghiJKLmnop",
      "slug": "acme-inc"
    }
  ]
}

Changes

  • 631143e91790Revision changes
    • info

      added the new optional header request parameter X-Monid-Agent-Harness

    • info

      added the new optional header request parameter X-Monid-Agent-Model

    • info

      added the new optional header request parameter X-Monid-Agent-Session-Id

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

    • info

      removed the PROMO_REDEEM_DISABLED enum value from the response property for the response status

  • b944bb23906cRevision changes
    • warning

      added the new PROMO_REDEEM_DISABLED enum value to the response property for the response status

    • warning

      added the new PROMO_REDEEM_DISABLED enum value to the response property for the response status

    • warning

      added the new PROMO_REDEEM_DISABLED enum value to the response property for the response status

    • warning

      added the new RATE_LIMITED enum value to the response property for the response status

    • warning

      added the new RATE_LIMITED enum value to the response property for the response status

    • warning

      added the new RATE_LIMITED enum value to the response property for the response status

    • info

      added the non-success response with the status