*API REST › Errores*

# `api_key_expired`

> 401. La clave ha superado su fecha de caducidad. Un token de acceso de OAuth caduca 1 hora después de emitirse. HTTP 401.

Estado HTTP: `401` · Tipo del problema: `https://docs.filmo.io/errors/api_key_expired`

## Cuándo ocurre

401. La clave ha superado su fecha de caducidad. Un token de acceso de OAuth caduca 1 hora después de emitirse.

## Qué hacer

Un administrador crea una clave nueva en los ajustes de API y MCP y sustituyes la caducada. En una conexión OAuth, el token de acceso dura 1 hora: renuévalo con el refresh token en lugar de crear una clave.

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

*api_key_expired*

```json
{
  "type": "https://docs.filmo.io/errors/api_key_expired",
  "title": "API key expired",
  "status": 401,
  "code": "api_key_expired",
  "detail": "The API key has expired",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c"
}
```

## Lo devuelven

`api_key_expired` 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/api_key_expired  
Última actualización: 2026-10-25