Docs
Errores
Códigos, forma del cuerpo y qué hacer con cada uno.
Cada error está pensado para desbloquearte, no solo para nombrar el problema: { code, message, hint?, issues? } — el campo hint indica exactamente cómo resolverlo, e issues señala el campo concreto que falla.
| HTTP | code | Causa habitual |
|---|---|---|
| 401 | unauthenticated | Falta la clave de API, está mal formada, revocada, o el prefijo no coincide con el tipo o el modo almacenados. |
| 403 | forbidden | Clave pk_ en un endpoint sk_, Origin no permitido, o rol insuficiente. |
| 401 | key_expired | La clave ha superado su fecha de caducidad. Crea o rota una. |
| 403 | secret_key_required | Una clave pk_ intentó registrar un consentimiento con source IMPORT o MIGRATION. Hazlo desde tu servidor con una clave sk_. |
| 403 | insufficient_scope | La clave secreta está limitada a otros scopes. Ver Consola → Sites & API keys. |
| 403 | ip_not_allowed | La clave secreta tiene allowlist de IPs y la petición viene de otra. |
| 403 | origin_not_verified | Clave pk_ LIVE con un Origin en un dominio aún sin verificar. |
| 404 | not_found | El sujeto o recurso no existe (los endpoints de lectura no crean sujetos). |
| 409 | idempotency_key_reused_with_different_body | Misma Idempotency-Key, cuerpo distinto. |
| 422 | validation_failed | El cuerpo no pasa el esquema Zod; revisa issues. |
| 429 | rate_limited | Reduce el ritmo; respeta Retry-After. |