Errors and troubleshooting

Complete error-family reference across iMessage resources

1xxx validation errors<p>Resolve missing, malformed, conflicting, oversized, unknown, or unsupported input.</p> <h2 id="how-it-works">How it works</h2> <p>Resolve missing, malformed, conflicting, oversized, unknown, or unsupported input.→
2xxx resource and state errors<p>Resolve permissions, not-found resources, idempotency conflicts, invalid state, and consent failures.</p> <h2 id="how-it-works">How it works</h2> <p>Resolve permissions, not-found resources, idempotency conflicts, inv→
3xxx transient errors<p>Retry unavailable authentication, storage, provider, event, and internal dependencies safely.</p> <h2 id="how-it-works">How it works</h2> <p>Retry unavailable authentication, storage, provider, event, and internal dep→
4xxx delivery and policy errors<p>Resolve offline devices, provider rejection, ineligible senders, quotas, and exhausted attempts.</p> <h2 id="how-it-works">How it works</h2> <p>Resolve offline devices, provider rejection, ineligible senders, quotas, →
5xxx media errors<p>Resolve upload, download, type, URL source, readiness, and capacity failures.</p> <h2 id="how-it-works">How it works</h2> <p>Resolve upload, download, type, URL source, readiness, and capacity failures.→
Capability errors<p>Resolve message-part support, chat type, and service capability mismatches.</p> <h2 id="how-it-works">How it works</h2> <p>Resolve message-part support, chat type, and service capability mismatches.→
Error envelope<p>Read HTTP status, stable code, field details, request ID, and retry guidance.</p> <h2 id="how-it-works">How it works</h2> <p>Read HTTP status, stable code, field details, request ID, and retry guidance.→
Payment and reputation errors<p>Resolve payment state, provider connections, line health, restrictions, and spending controls.</p> <h2 id="how-it-works">How it works</h2> <p>Resolve payment state, provider connections, line health, restrictions, and→
Troubleshooting playbook<p>Collect safe evidence, stop amplification, reconcile authoritative state, and contact support.</p> <h2 id="how-it-works">How it works</h2> <p>Collect safe evidence, stop amplification, reconcile authoritative state, a→
Webhook and replay errors<p>Resolve endpoints, signatures, secrets, cursors, deliveries, replay ranges, and terminal state.</p> <h2 id="how-it-works">How it works</h2> <p>Resolve endpoints, signatures, secrets, cursors, deliveries, replay ranges→