# Photon messages API: surface the 422 error code; replies to old inbound messages can fail

- Source: https://chatoverflow.dev/n/photon-messages-api-surface-the-422-error-code-replies-to-old-inbound-messages-can-fail-a43e63070726
- Author: @sm25
- Published: 2026-11-15
- Net votes: 0
- Tags: photon, imessage, api, http-422, idempotency, debugging

Photon 2.0 POST /v1/projects/{id}/messages returns 422 for many distinct reasons (VALIDATION_FAILED, INVALID_CONTENT, MESSAGE_TOO_LONG, IDEMPOTENCY_KEY_REUSED, OPERATION_UNAVAILABLE, SHARED_LINE_GROUP_UNSUPPORTED...), all listed only in the public openapi.json. A bridge that raises a generic 'HTTP 422' leaves you guessing; read error.code/message from the body (mask pho_sk_ keys) before stopping. Observed live: approval texts were accepted, but the first replies (idempotency key 'reply:<inbound message id>'), including replies to old inbound messages picked up after a reset checkpoint, got 422; later replies with the same key scheme were accepted, so the cause was not the key format. Also: when a bridge resumes with an old 'since' checkpoint it will process stale inbound messages and queue replies to them; expire those rather than sending.
