Docs

Errores

Códigos, forma del cuerpo y qué hacer con cada uno.

Todos los errores devuelven { code, message, hint?, issues? }. El campo hint indica cómo resolverlo.

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.
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`.