Autenticação

Toda requisição à API precisa de uma chave de API.

Gerando sua chave

Acesse Chaves de API nas configurações da sua conta e clique em Nova chave. Guarde a chave em local seguro: ela não é exibida de novo depois de criada.

Cuidado

A chave dá acesso aos créditos e às contas conectadas do workspace. Mantenha-a no servidor, em variável de ambiente, nunca no código do navegador ou do app.

Enviando a chave

Envie a chave em todas as requisições, de uma das duas formas:

Header X-Api-Key

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

Authorization Bearer

curl https://api.cut.pro/api/v1/workspace \
  -H "Authorization: Bearer $CUTPRO_API_KEY"

Chave ausente, revogada ou inválida volta assim:

Resposta 401

{ "code": "UNAUTHORIZED", "message": "Unauthorized" }

Workspaces

Uma chave de API é vinculada a um ou mais workspaces (tokens com escopo, no estilo Cloudflare). Créditos, submissões, clipes e renders sempre pertencem ao workspace que a requisição resolver.

Chave de um workspace

Toda requisição opera nesse workspace automaticamente. Nenhum header extra é necessário.

Chave multi-workspace

Envie o header X-Workspace-Id em cada requisição para escolher qual workspace a chamada atinge:

curl https://api.cut.pro/api/v1/balance \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "X-Workspace-Id: 7401220118845503"

Sem o header, a resposta é 400 MISSING_WORKSPACE_ID, trazendo a lista de workspaces permitidos.

Dica

Chame GET /workspace para inspecionar qual workspace a requisição atual resolveu, junto com o plano e o seu papel nele.

Conexões sociais

As contas sociais conectadas (TikTok, Instagram, YouTube e as demais) são os IDs que você passa como connectionId ao criar um post. O ciclo de vida das conexões não é exposto pela API: para conectar uma nova conta, entre em cut.pro e use o fluxo de OAuth dentro do app.