Errores

`unauthorized`

401. La petición no se autenticó: no llegó ninguna clave de API como bearer token en la cabecera Authorization. Todas las operaciones requieren una. Sin la cabecera Accept-Language, el cuerpo de este error llega en español, porque no hay propietario de la clave al que preguntar. HTTP 401.

Estado HTTP: 401
Tipo del problema: https://docs.filmo.io/errors/unauthorized

{
  "type": "https://docs.filmo.io/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "code": "unauthorized",
  "detail": "Missing Authorization header: Bearer <api key>",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c"
}

Cuándo ocurre

401. La petición no se autenticó: no llegó ninguna clave de API como bearer token en la cabecera Authorization. Todas las operaciones requieren una. Sin la cabecera Accept-Language, el cuerpo de este error llega en español, porque no hay propietario de la clave al que preguntar.

Qué hacer

Envía Authorization: Bearer <key> en cada petición, con una clave creada en los ajustes de API y MCP de la app (Ajustes → API y MCP). Envía Accept-Language: en para recibir los mensajes en inglés.

Reintento

Parar401 · 402 · 403 (clave, propietario o plan)
No reintentes: reenviar la misma petición vuelve a fallar. Actúa sobre la clave, su propietario o el plan: usa una clave válida con el permiso adecuado, pide a un administrador el permiso que falta o contrata el add-on.

Lo devuelven

unauthorized los puede devolver cualquier operación.

Por MCP

Una llamada a una herramienta que falla vuelve con `isError` y el problema como contenido estructurado, con el mismo `code`.

¿Te ha resultado útil esta página?

Ejemplo

Cuándo ocurre

Qué hacer

Reintento

Lo devuelven

Por MCP