Autenticación

Toda solicitud lleva una clave de API. La clave define la cuenta, el workspace y de quién salen los créditos.

Crea una claveCopy Anchor Link

Abre Claves de API y haz clic en Nueva clave. La clave aparece una sola vez: cópiala y guárdala en tu gestor de secretos. Las claves de API están en los planes Gratuito, Básico, Plus y Pro.

Envía la claveCopy Anchor Link

Usa el header X-Api-Key:

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

O Authorization: Bearer, si tu cliente HTTP ya arma ese header:

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

Una clave ausente, revocada o vencida responde 401:

{ "code": "UNAUTHORIZED" }

Una cuenta bloqueada responde 403 con ACCOUNT_BLOCKED. En ese caso ninguna clave de la cuenta funciona: habla con soporte.

WorkspacesCopy Anchor Link

Créditos, videos, clips, renders y conexiones pertenecen a un workspace. La clave está vinculada a uno o más workspaces, y cada solicitud opera en exactamente uno.

Clave con un workspaceCopy Anchor Link

No hay nada que hacer. Toda solicitud cae en el workspace de la clave.

Clave con más de un workspaceCopy Anchor Link

Envía X-Workspace-Id en cada solicitud:

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

Sin el header, la API responde 400 y lista los workspaces que la clave alcanza:

{
  "code": "MISSING_WORKSPACE_ID",
  "extra": { "allowed_workspace_ids": ["7401220118845503", "7401220118845991"] }
}

Un id fuera de esa lista responde 400 WORKSPACE_NOT_AUTHORIZED, con la misma lista en extra.

Para saber en qué workspace cayó la solicitud, con plan y rol, llama a GET /workspace.

Cuentas socialesCopy Anchor Link

Para publicar, el workspace necesita cuentas conectadas. GET /connections lista las que existen y devuelve el id que va en connection_id del post. ¿Falta una red? GET /connections/link?platform=tiktok devuelve un enlace de Cut.Pro que abre el inicio de sesión de esa red. Entrega el enlace a la persona, espera a que vuelva y lista de nuevo. Ve Publicación.

Buenas prácticasCopy Anchor Link

• Una clave por integración. Si una se filtra, revocas solo esa.
• Revoca lo que no uses. La página de claves muestra cada clave, y revocar vale al instante.
• No registres el header en logs. Muchos clientes HTTP guardan los headers en modo debug.