inboxes
Revoke a sender claim
DELETE /v1/verified-senders/{id}
Auth required
api.inboxes.manage
Removes the claim. Reversible: verify the address again and you have it back, because the proof is a code sent to a mailbox you can read.
It does NOT unrestrict inboxes already minted against this address.
An inbox's allowed_senders is frozen at mint and restricted records
what was true then. Retroactively loosening a live inbox would turn an
act of tightening into one that opened somebody's inbox to strangers.
Requires a user-delegated token.
Path parameters
id string<uuid> required The claim's UUID, as returned by POST /v1/verified-senders.
Responses
Errors follow the RFC 7807 problem format — see the error reference.
204 The claim is revoked
401 Missing, malformed, or unknown API key application/problem+json
403 Either the credential lacks the required scope (
code: invalid_scope), or it is bound to the test environment and this operation is irreversible (code: test_environment_forbidden). Branch on code: the first is fixed by granting the scope, the second only by using a live credential. See the "Live and test credentials" section of the API description. application/problem+json 404 Resource not found application/problem+json
422 A query parameter, path value or body field failed validation.
The body is a
validation_failed Problem. When the refusal is about a
reference — a segment key, template slug, topic or attribute name the
organization does not have — it additionally carries validation_code,
field, line/column, missing, candidates and next_step, so a
client can correct the call without a second round of guessing. See
ValidationProblem.
application/problem+json 429 Per-org rate limit exceeded application/problem+json
500 Unexpected server-side failure. The
code is internal_error. The
request_id field can be quoted to SendOps support to investigate.
application/problem+json