Skip to Content
Error codesError codes

Error codes

Every problem+json error body the kit emits carries a type URL of the form https://hephkit.dev/errors/<code>. Each code has its own page with the caller-facing message and developer guidance.

CodeStatusTitle
HEPH-GEN-500500Internal error
HEPH-VAL-422422Validation failed
HEPH-NF-404404Resource not found
HEPH-AUTH-401401Authentication required
HEPH-AUTH-403403Permission denied
HEPH-RATE-429429Rate limit exceeded
HEPH-IDEMP-400400Idempotency key missing or malformed
HEPH-IDEMP-409409Original request still in flight
HEPH-IDEMP-422422Idempotency key reused with a different payload
HEPH-MONEY-422422Invalid money amount
HEPH-MONEY-409409Currency mismatch
HEPH-WH-401401Webhook signature invalid or expired

The registry is spec/errors.yaml; these pages are generated from it.