*API REST › Errores*

# `internal_error`

> 500. Algo falló por parte de Filmo, o el almacén que cuenta el límite de peticiones no estaba disponible (la API no deja pasar la petición sin medirla). Con una `Idempotency-Key`, un 500 puede ocurrir después de confirmarse la escritura (no se pudo construir la respuesta); ese error se guarda entonces y se reproduce con `Idempotent-Replay: true` durante 24 horas, así que reenviar no escribe dos veces y tampoco se recupera. HTTP 500.

Estado HTTP: `500` · Tipo del problema: `https://docs.filmo.io/errors/internal_error`

## Cuándo ocurre

500. Algo falló por parte de Filmo, o el almacén que cuenta el límite de peticiones no estaba disponible (la API no deja pasar la petición sin medirla). Con una `Idempotency-Key`, un 500 puede ocurrir después de confirmarse la escritura (no se pudo construir la respuesta); ese error se guarda entonces y se reproduce con `Idempotent-Replay: true` durante 24 horas, así que reenviar no escribe dos veces y tampoco se recupera.

## Qué hacer

Anota el `requestId` (es también la cabecera `X-Request-Id`). Si la petición era una escritura, lee el recurso para ver en qué estado está antes de hacer nada más. Si la misma petición sigue fallando, contacta con el soporte indicando el `requestId`.

## Reintento

| Condición | Qué hacer | Nota |
| --- | --- | --- |
| 500 internal_error · Idempotency-Key: Sí · Idempotent-Replay: true | Parar | Para. El fallo ocurrió después del commit y se guarda y se repite durante 24 h con esa clave: lee el recurso para ver dónde quedó. |
| 500 internal_error · Idempotency-Key: Sí | Reintentar con espera exponencial | Reintenta con espera exponencial y la misma clave. |
| 500 internal_error · Idempotency-Key: No | Leer antes el recurso | Lee antes de reintentar una escritura: sin clave nada te protege de un duplicado. |

## Ejemplo

*internal_error*

```json
{
  "type": "https://docs.filmo.io/errors/internal_error",
  "title": "Internal error",
  "status": 500,
  "code": "internal_error",
  "detail": "Internal error",
  "requestId": "req_0b9f6c1d2e3a4f5a8b7c6d5e4f3a2b1c"
}
```

## Lo devuelven

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