*API REST › 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`

## 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

| Condición | Qué hacer | Nota |
| --- | --- | --- |
| 401 · 402 · 403 (clave, propietario o plan) | Parar | 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. |

## Ejemplo

*unauthorized*

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

## 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`.

---

URL canónica: https://docs.filmo.io/es/rest-api/errors/unauthorized  
Última actualización: 2026-10-25