suppressions

Suppress an address or a whole domain (send "@example.com").

Idempotent — an existing row is returned.

post/suppressions

Request

  • Base URL: https://api.agentisend.com
  • URL: https://api.agentisend.com/suppressions
  • 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

emailstring required

An address, or @example.com to suppress a whole domain.

level'address' | 'domain'

address or domain. Inferred from the value when omitted.

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

Defaults to manual.

Response

Success

object'suppression' required
idstring uuid required
emailstring required
level'address' | 'domain' | 'global' required
originstring required
created_atstring date-time required
source_idstring nullable required
stream'transactional' | 'marketing' nullable required
platformboolean required

Changes

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