API Reference
Every route this deployment serves, with request fields, examples and responses.
sesameSend speaks the same HTTP API as the Resend SDKs expect. This reference lists the 142 operations that have a route in the app, generated from the OpenAPI document in the repository (MIT licensed, copyright Plus Five Five, Inc; the notice ships next to the file as resend-openapi.LICENSE).
Base URL
Use your own deployment origin, for example https://mail.example.com. Every example on these pages reads it from $SESAMESEND_URL.
Authentication
Send an API key as a bearer token. Keys start with os_.
curl "$SESAMESEND_URL/domains" -H "Authorization: Bearer $OPENSEND_API_KEY"Create keys in the dashboard or with POST /api-keys. A full_access key can call everything. A sending_access key can only send mail.
Pagination
List routes take limit (1 to 100, default 20), after and before cursors. Use one cursor at a time.
Idempotency
Send an Idempotency-Key header (1 to 256 characters) on write requests. A retry with the same key and body within 24 hours returns the stored response with idempotent-replayed: true. The same key with a different body returns 409 invalid_idempotent_request.
Errors
Errors are JSON: { "statusCode": 422, "name": "validation_error", "message": "..." }. A paused team gets 403 sending_paused, and a failed guardrail check returns 503 guardrail_unavailable. Past the rate limit you get 429 rate_limit_exceeded with a retry-after header. See Rate limits and quotas.
Not yet exercised
Four current routes exist but have not yet returned a 2xx to a real request on the reference instance: the three domain claim routes and POST /emails/batch. The deprecated GET /audiences/{id} is also unexercised. They are marked on their pages.