Authentication

API Keys

All API requests require a Bearer token in the Authorization header.

Authorization: Bearer sr_live_YOUR_API_KEY

API keys are scoped to a workspace. Any action performed with the key operates within that workspace's context (videos, clips, minutes balance, etc.).

Getting your API key

1. Log in to ScaleReach
2. Go to Workspace Settings → API Keys
3. Click Create API Key
4. Copy the key immediately — it's only shown once

Key format

All ScaleReach API keys start with sr_live_ followed by 48 hex characters:

sr_live_a3f8b2c1d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3

Getting your Workspace ID

You need your workspaceId for most API calls. Retrieve it with:

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

Response:

[
  {
    "id": "abc123def456",
    "name": "My Workspace",
    "slug": "my-workspace",
    "plan": "pro",
    "role": "owner"
  }
]

Use the id field as your workspaceId in subsequent requests.

Error responses