*API REST › Errores*

# `forbidden`

> HTTP HTTP 403.

Estado HTTP: `403` · Tipo del problema: `https://docs.filmo.io/errors/forbidden`

## Cuándo ocurre

403. La clave es correcta, pero su propietario no tiene el permiso de módulo, de organización o de administrador que exige la operación. Esto afecta al propietario de la clave; [`insufficient_scope`](https://docs.filmo.io/es/rest-api/errors/insufficient_scope) afecta a la clave y [`addon_required`](https://docs.filmo.io/es/rest-api/errors/addon_required) afecta al plan.

## Qué hacer

Un administrador de la cuenta concede al propietario el permiso que falta, o usas una clave cuyo propietario lo tenga. Cambiar los scopes de la clave no ayuda.

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

*forbidden*

```json
{
  "type": "https://docs.filmo.io/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "code": "forbidden",
  "detail": "You are not allowed to perform this operation",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c"
}
```

## Lo devuelven

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