List Workspaces

GET /api/workspaces

Returns the workspace your API key belongs to. Because an API key is scoped to a single workspace, the array contains exactly one item when you authenticate with a key (or an empty array if that workspace no longer exists). Use it to discover the workspaceId that other endpoints need.

Example

curl https://api.scalereach.ai/api/workspaces \
  -H "Authorization: Bearer sr_live_YOUR_KEY"

import requests

response = requests.get(
    "https://api.scalereach.ai/api/workspaces",
    headers={"Authorization": "Bearer sr_live_YOUR_KEY"},
)
workspaces = response.json()
workspace_id = workspaces[0]["id"]  # Use this for other API calls

Response 200

[
  {
    "id": "znrje9lkcidmmaiziti",
    "name": "My Workspace",
    "slug": "my-workspace",
    "description": null,
    "logo": "https://cdn.scalereach.ai/workspaces/logo.png",
    "plan": "pro",
    "billingCycle": "monthly",
    "role": "owner",
    "createdAt": "2026-01-21T18:41:34.819Z",
    "updatedAt": "2026-03-12T09:49:24.046Z"
  }
]

Why you get one workspace

Logging in to the dashboard with your account can show several workspaces, but an API key is deliberately limited to the workspace it was created in. That limit protects your other workspaces if a key leaks. If you manage several workspaces, create one key per workspace and store each key with a label that names the workspace.

Response fields

Each item has id, name, slug, description, logo, plan, billingCycle, role, createdAt and updatedAt. The role field is your role in that workspace, such as owner or member. See Get Workspace for what each field means.

Errors

Typical first request

Almost every integration starts with this call. Read the id once, then reuse it as workspaceId for List Videos and any other endpoint that asks for it. The ID does not change, so you can store it in a configuration file instead of calling this endpoint every time.