# White-label

> Ofrece recortes, renders y publicación con tu marca: un workspace por cliente y un enlace para que conecte sus propias redes, sin cuenta en Cut.Pro.

Los [términos de uso](https://cut.pro/terms) permiten revender la API, ofrecerla en white-label y construir tu propio producto sobre ella, con tu marca y tu precio, sin contrato aparte. Esta página muestra el flujo: cada cliente tiene un workspace, conecta sus redes con un enlace y tú operas todo por la API.

## 1. Crea un workspace por cliente

El workspace separa los videos, clips, renders, cuentas conectadas y publicaciones de cada cliente.

```bash
curl -X POST https://api.cut.pro/api/v1/workspaces \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Panadería Central" }'
```

```json title="201 Created"
{ "id": "7412990011220001", "name": "Panadería Central", "is_personal": false, "created_at": "2026-11-20T15:00:00.000Z" }
```

La clave que lo creó ya alcanza el workspace nuevo. Guarda el `id` junto al cliente en tu sistema y envíalo en `X-Workspace-Id` en cada llamada de ese cliente:

```bash
curl https://api.cut.pro/api/v1/connections \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "X-Workspace-Id: 7412990011220001"
```

Sin el header, las solicitudes siguen cayendo donde caían antes de que crearas workspaces, así que lo que ya funcionaba no cambia. `GET /workspaces` los lista y `PATCH /workspaces/{id}` cambia el nombre.

> Los créditos y el plan son de cada workspace. Un workspace nuevo empieza en el plan gratuito, sin créditos.

## 2. Pide el enlace de conexión

```bash
curl -X POST https://api.cut.pro/api/v1/connections/link \
  -H "X-Api-Key: $CUTPRO_API_KEY" \
  -H "X-Workspace-Id: 7412990011220001" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "instagram",
    "return_url": "https://app.tumarca.com/clientes/42/redes",
    "state": "cliente-42"
  }'
```

```json title="200 OK"
{ "url": "https://api.cut.pro/api/v1/connections/start?link=…", "expires_at": "2026-11-21T15:00:00.000Z" }
```

Entrega el `url` a tu cliente: en un botón de tu panel, por correo o por mensaje. Lo abre, inicia sesión en la red y autoriza. Nadie necesita cuenta en Cut.Pro.

| Campo | Qué hace |
|---|---|
| `platform` | `youtube`, `tiktok`, `instagram`, `facebook`, `threads`, `linkedin`, `pinterest`, `bluesky`, `twitch`, `kick` o `discord`. |
| `return_url` | Adónde va la persona al terminar. `https`, o `http` en `localhost` mientras pruebas. Sin él, llega a Cut.Pro. |
| `state` | Cualquier texto tuyo, hasta 512 caracteres, que vuelve intacto. Úsalo para saber de qué cliente es la respuesta. |
| `connection_id` | Reconecta una cuenta cuyo acceso se perdió, conservando su `id` y las publicaciones programadas. |

El enlace sirve una vez y vence en 24 horas. Si la persona cancela o el inicio de sesión falla, el mismo enlace vuelve a funcionar. Mientras un inicio de sesión está en curso, una segunda pestaña recibe `LINK_IN_USE`.

## 3. Recibe el regreso

Cuando la persona termina, el navegador va al `return_url` con:

| Parámetro | Valor |
|---|---|
| `status` | `connected` o `error`. |
| `platform` | La red del enlace. |
| `connection_ids` | Los `id` de las cuentas conectadas, separados por comas. Llega más de uno cuando un inicio de sesión de Facebook autoriza varias Páginas. |
| `warning` | `FACEBOOK_PAGES_PARTIAL` cuando parte de las Páginas no cupo en el límite. |
| `code` | En `error`, el motivo, como `LINK_EXPIRED`, `LINK_USED`, `CONNECTION_LIMIT_REACHED` o el error que devolvió la red. |
| `state` | Tu `state`, tal como lo enviaste. |

```text
https://app.tumarca.com/clientes/42/redes?status=connected&platform=instagram&connection_ids=7412990011229001&state=cliente-42
```

El regreso pasa por el navegador de la persona. Antes de guardar la conexión en tu sistema, confírmala con `GET /connections/{id}` en el workspace del cliente en lugar de confiar solo en la URL.

> La conexión ocurre sin ninguna pantalla de Cut.Pro en medio. Por eso Facebook conecta todas las Páginas que la persona autorizó, LinkedIn conecta el perfil y Tumblr el blog principal, hasta el límite de cuentas del plan.

## 4. Opera como siempre

Con el `X-Workspace-Id` del cliente, el resto de la API funciona igual: [recorta](https://cut.pro/docs/es/clipping), [renderiza](https://cut.pro/docs/es/rendering) y [publica](https://cut.pro/docs/es/publishing) en sus cuentas. Para entregar el video desde tu dominio, descarga el MP4 y sírvelo desde tu almacenamiento.

## Lo que todavía se ve

- La pantalla de autorización de Google, TikTok y Meta muestra el nombre de la aplicación, que es el de Cut.Pro. Cada red exige una aplicación revisada por ella, así que ese nombre no cambia por cliente.
- El enlace de conexión pasa por `api.cut.pro` un instante antes de abrir el inicio de sesión de la red.

## Errores

| Code | Cuándo |
|---|---|
| `WORKSPACE_LIMIT_REACHED` | La cuenta llegó al límite de workspaces creados por la API. |
| `INVALID_RETURN_URL` | `return_url` no es `https` (ni `http` en `localhost`). |
| `CONNECTION_LIMIT_REACHED` | El workspace ya tiene el máximo de cuentas de esa red que permite el plan. |
| `PLATFORM_UNAVAILABLE` | El plan del workspace no incluye la red, o todavía no se liberó. |
| `CONNECTION_NOT_FOUND` | El `connection_id` para reconectar no es de este workspace o es de otra red. |
