suppressions

Lift up to 500 suppressions by address.

An address that was not suppressed reads not_found, not an error.

post/suppressions/batch/remove

Request

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

Addresses to lift.

idsstring[]

Suppression ids to lift, as GET /suppressions returns them.

level'address' | 'domain'

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

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

Defaults to manual.

Example request

{
  "emails": [
    "former-customer@example.com"
  ]
}

Response

Success

Changes

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