List Workspaces

GET /v1/auth/workspaces

List the workspaces your API key or OAuth access token has access to. Use the returned workspace IDs to set the x-workspace-id header on subsequent requests.

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <api-key>` or OAuth access token

Example Request

curl "https://api.monid.ai/v1/auth/workspaces" \
  -H "Authorization: Bearer monid_live_..."

const res = await fetch("https://api.monid.ai/v1/auth/workspaces", {
  headers: { Authorization: "Bearer monid_live_..." },
});

import requests

res = requests.get(
    "https://api.monid.ai/v1/auth/workspaces",
    headers={"Authorization": "Bearer monid_live_..."},
)

200 OK

Field	Type	Description
`items`	array	Workspaces the caller can access
`items[].workspaceId`	string	Workspace identifier — pass as `x-workspace-id`
`items[].name`	string	Workspace display name
`items[].role`	string	Caller’s role in the workspace

Example Response

{
  "items": [
    {
      "workspaceId": "ws_abc123",
      "name": "Acme, Inc.",
      "role": "owner"
    },
    {
      "workspaceId": "ws_def456",
      "name": "Personal",
      "role": "owner"
    }
  ]
}

Using a Workspace ID

Every Monid API request should include the x-workspace-id header so Monid knows which workspace to operate against:

curl -X POST https://api.monid.ai/v1/discover \
  -H "Authorization: Bearer monid_live_..." \
  -H "x-workspace-id: ws_abc123" \
  -H "Content-Type: application/json" \
  -d '{"query":"twitter posts"}'

Auth

Endpoints

Runs

Wallet

List Workspaces

Headers

Example Request

200 OK

Example Response

Using a Workspace ID

​Headers

​Example Request

​200 OK

​Example Response

​Using a Workspace ID

Headers

Example Request

200 OK

Example Response

Using a Workspace ID