API reference

Detach domain from a provider

Removes a sending domain verification, stopping email delivery through that provider for this domain. Required role: admin or owner.

DELETE/v1/admin/sending-domains/:id/verifications/:verificationId

Authenticate with a session token and X-Tenant-Slug. Required role: admin or owner.

Marks the verification record as deleted in Nudgel's database. The domain will no longer be used for sending through the associated provider config. Obtain the verificationId from GET .../verifications.

Request

curl

curl -X DELETE https://api-raven-cloud.autotribes.app/v1/admin/sending-domains/$DOMAIN_ID/verifications/$VERIFICATION_ID \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Tenant-Slug: my-tenant"

Response

204 No Content

Empty body. The verification record is marked deleted and will no longer appear in list or get responses.

Provider-side cleanup

PROVIDER DOMAIN NOT DELETED

Detaching a verification does not call the provider's delete-domain API. The domain registration remains active on the provider side. This is intentional — provider API calls can fail or be slow, and deleting the wrong record could break other tenants on shared IP pools. A background cleanup job will handle provider-side deletion in a future release. See the roadmap for status.

If you need to immediately remove the domain from a provider (e.g. Postmark, SES), do so directly in that provider's dashboard after calling this endpoint.

Errors

Status	When
`401`	Invalid or expired session token
`403`	Caller does not have admin or owner role
`404`	Sending domain or verification not found for this tenant