Autenticación

Toda petición a la API necesita una clave de API.

Generando tu clave

Entra en Claves de API en los ajustes de tu cuenta y pulsa Nueva clave. Guarda la clave en un lugar seguro: no se vuelve a mostrar después de creada.

Enviando la clave

Envía la clave en todas las peticiones, de una de las dos formas:

Header X-Api-Key

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

Authorization Bearer

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

Workspaces

Una clave de API está vinculada a uno o más workspaces (tokens con alcance, al estilo de Cloudflare). Los créditos, los envíos, los clips y los renders siempre pertenecen al workspace que resuelva la petición.

Clave de un workspace

Toda petición opera en ese workspace automáticamente. No hace falta ningún header extra.

Clave multi-workspace

Envía el header X-Workspace-Id en cada petición para elegir a qué workspace llega la llamada:

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

Sin el header, la respuesta es 400 MISSING_WORKSPACE_ID, con la lista de workspaces permitidos.

Consejo

Llama a GET /workspace para ver qué workspace resolvió la petición actual, junto con el plan y tu rol en él.

Conexiones sociales

Las cuentas sociales conectadas (TikTok, Instagram, YouTube, etc.) son los IDs que pasas como connection_id al crear una publicación. El ciclo de vida de las conexiones no se expone por la API: para conectar una cuenta nueva, entra en cut.pro y usa el flujo de OAuth dentro de la app.