Errores

Un sobre. type para la familia, code estable, request_id para el log.

Contenido oficial AivyroAlineado con el contrato público actual

HTTP	type	Cuándo
400	invalid_request_error	Cuerpo o query inválidos
401	authentication_error	Clave ausente, inválida o revocada
403	permission_error	Falta alcance REST
404	not_found_error	Id desconocido, otro tenant o path fuera del catálogo
429	rate_limit_error	Sobre el límite de la clave
500	api_error	Inesperado. Reintenta create con la misma idempotency key
503	api_error	Downstream no disponible. Los writes de webhook también usan esto cuando el plano de entrega está off

Reintenta 429 y 500 (con idempotencia en escrituras). No entres en bucle en 400/401/403/404. 503 en webhook es “plano de entrega off”, no “reintenta hasta que aparezca una fila”.

error

{
  "error": {
    "type": "not_found_error",
    "code": "resource_not_found",
    "message": "This resource is not available on the public REST API",
    "request_id": "req_…"
  }
}