Errores

Todo error tiene la forma:

{
  "error": {
    "type": "validation_error",
    "code": "invalid_request",
    "message": "due_date must be a valid ISO-8601 datetime",
    "request_id": "req_6a2918cff58b0a1d387866ee",
    "errors": [{ "field": "due_date", "message": "must be a valid ISO-8601 datetime" }]
  }
}

• type — una categoría amplia y estable.
• code — una cadena estable y legible por máquina.
• request_id — cítalo al contactar con soporte.
• errors[] — detalles por campo para fallos de validación (presente solo cuando es relevante).

Catálogo

HTTP	type	code	Significado
401	authentication_error	unauthorized, expired	Clave de API ausente, inválida, revocada o expirada.
403	permission_error	insufficient_scope	La clave no tiene el acceso requerido, o el recurso está fuera de su alcance.
404	not_found_error	resource_not_found	El recurso no existe o no es visible para esta clave.
409	conflict_error	already_exists	El recurso ya existe, o se reutilizó una Idempotency-Key con un cuerpo de solicitud diferente.
422	validation_error	invalid_request	La solicitud no pasó la validación; consulta errors[] para ver los campos problemáticos.
429	rate_limit_error	too_many_requests	Demasiadas solicitudes; reintenta tras el retardo indicado en la cabecera Retry-After.
500	api_error	internal_error	Error inesperado del servidor; es seguro reintentar más tarde.

Las respuestas de error también incluyen un doc_url que apunta de vuelta a esta página.