Delete an email address

deletehttps://api.nsin.ir/domains/{domain}/email-routing/rules/{ruleId}

Auth: Authorization: Bearer nsin_… or X-Api-Key: nsin_… — see API keys.

Removes one address. Mail to it is then handled by the catch-all, or rejected when the catch-all is off. It frees a slot of the plan's address allowance. The mail hosts pick the change up within a minute. Requires records.edit.

Path parameters

domainstringrequiredpath

The domain name (for example example.com) — not a numeric id.
ruleIdintegerrequiredpath

Numeric id of the email address rule, from the rule list.

Responses

204Deleted.

401Missing, malformed, revoked or expired API key. (A valid key whose account has been deactivated gets 403 account is inactive instead.)

Content type: application/json

errorstringrequired

Human-readable description of what went wrong.

json

{
  "error": "invalid API key"
}

403The key is read-only, your role on the domain lacks the required permission, or the domain's plan does not include the feature.

Content type: application/json

errorstringrequired

Human-readable description of what went wrong.

json

{
  "error": "read-only API key"
}

404No such domain, or no such rule on it.

Content type: application/json

errorstringrequired

Human-readable description of what went wrong.

json

{
  "error": "read-only API key"
}

429The key exceeded its request budget (300 requests per minute by default).

Content type: application/json

errorstringrequired

Human-readable description of what went wrong.

json

{
  "error": "rate limit exceeded"
}

Example request

bash

curl -X DELETE "https://api.nsin.ir/domains/example.com/email-routing/rules/0" \
  -H "Authorization: Bearer $NSIN_API_KEY"