List workspaces

GET/v1/api/workspaces

List accessible workspaces for OAuth users, or current workspace for API keys.

Scope: Any of sites:read, workspaces:read
Token: API key or OAuth access token
Role: Any workspace member
MCP tool: list_workspaces; What scopes, tokens and roles mean →

Request

curl "https://api.crawle.io/v1/api/workspaces" \
  -H "Authorization: Bearer $CRAWLE_API_KEY"

const response = await fetch("https://api.crawle.io/v1/api/workspaces", {
  headers: {
    Authorization: `Bearer ${process.env.CRAWLE_API_KEY}`,
  },
});
const data = await response.json();

import os

import requests

response = requests.request(
    "GET",
    "https://api.crawle.io/v1/api/workspaces",
    headers={
        "Authorization": f"Bearer {os.environ['CRAWLE_API_KEY']}",
    },
)
data = response.json()

$CRAWLE_API_KEY: is an API key from Settings › API keys.

Response 200JSON

{
  "items": [
    {
      "capabilities": {
        "log_analysis": false
      },
      "id": "example",
      "timezone": "UTC"
    }
  ],
  "total": 1
}

Example generated from the API contract.

Response 200

itemsarray of IntegrationWorkspaceMetadatarequired
capabilitiesWorkspaceCapabilities
log_analysisboolean: default false
idstringrequired
timezonestring: default "UTC"
totalintegerrequired

Errors

401
When
Missing, invalid, or expired token.
403
When
The token has none of the accepted scopes (sites:read, workspaces:read).
429
When
Rate limited. Wait for Retry-After seconds.

List workspaces: errors
Status	When
401	Missing, invalid, or expired token.
403	The token has none of the accepted scopes (`sites:read`, `workspaces:read`).
429	Rate limited. Wait for `Retry-After` seconds.

All errors and what to do →

Generated from the API contract at 7e7039b0b, synced October 30, 2026.