API Concepts
Learn how pagination, errors, idempotency, and versioning work before you connect Mailrith to a sync flow.
Pagination
Page through large list endpoints safely with cursors, saved progress, and reusable sync loops.
Errors
Read Mailrith error envelopes, map status codes to behavior, and decide when retrying a request is safe.
Idempotency
Retry import and export job creation safely with the `Idempotency-Key` header.
Versioning
Pin clients to the `/v1` path contract and plan future upgrades with the OpenAPI document.
Consent And Privacy API Boundaries
Understand which Subscriber privacy fields the public API accepts and when to use Mailrith-hosted consent workflows instead.