suppressions

Suppress up to 500 addresses in one call.

Each item succeeds or fails on its own — read data[i].status.

post/suppressions/batch/add

Request

  • Base URL: https://api.agentisend.com
  • URL: https://api.agentisend.com/suppressions/batch/add
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Makes this call safe to retry. Send the same key with the same body and the original response is replayed instead of the work happening twice. Keys are 1-256 characters and are remembered for 7 days. While the first attempt is still running, a second call with that key returns 409 idempotency_in_flight (Resend calls this concurrent_idempotent_requests); the same key with a different body returns 409 idempotency_payload_mismatch (Resend: invalid_idempotent_request). Resend-Idempotency-Key is accepted as the same header.

Resend-Idempotency-Keystring

Alias of Idempotency-Key. Idempotency-Key wins if both are sent.

Request body

emailsstring[] required

Addresses to change. At most 500.

level'address' | 'domain'

address or domain, applied to every item. Inferred when omitted.

origin'bounce' | 'complaint' | 'manual'

Defaults to manual.

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.