Authentication - Cut.Pro

Every API request needs an API key.

Generating your key

Go to API keys in your account settings and click New key. Store the key somewhere safe, it is not shown again after it is created.

Sending the key

Send the key in every request, in one of two ways:

curl https://api.cut.pro/api/v1/workspace \
  -H "X-Api-Key: YOUR_KEY"

Workspaces

An API key is bound to one or more workspaces (scoped tokens, Cloudflare style). Credits, submissions, clips, and renders always belong to the workspace the request resolves to.

Single-workspace key
Multi-workspace key

Every request operates on that workspace automatically. No extra header is needed.

Send the X-Workspace-Id header on each request to choose which workspace the call hits:

curl https://api.cut.pro/api/v1/balance \
  -H "X-Api-Key: YOUR_KEY" \
  -H "X-Workspace-Id: WORKSPACE_ID"

Without the header, the response is 400 MISSING_WORKSPACE_ID, including the list of allowed workspaces.

Call GET /workspace to inspect which workspace the current request resolved to, along with the plan and your role in it.

Connected social accounts (TikTok, Instagram, YouTube, etc.) are the IDs you pass as connection_id when creating a post. The lifecycle of connections is not exposed by the API. To connect a new account, go to cut.pro and use the OAuth flow inside the app.

Last modified on June 2, 2026

API overview Quickstart: your first clip

​Generating your key

​Sending the key

​Workspaces

​Social connections

Generating your key

Sending the key

Workspaces

Social connections