Delete a sending domain

Deletes the domain for good: no read finds it again, its name is free for a new domain of the project, and its DKIM private key is not kept. Records domain.deleted. The domain’s records stay in DNS: remove them at the provider. A second call finds nothing (404). Needs scope write. A domain with a campaign in sending will be refused (409) once campaigns exist (P5).

Parameters

Name	In	Type	Description
`project_id`required	path	string · uuid	The project’s id
`domain_id`required	path	string · uuid	The domain’s id

Request body

None.

Responses

204

The domain is deleted

No content.

401

No valid key

Problem (application/problem+json)

403

A project key without scope write (forbidden)

Problem (application/problem+json)

404

No such project or domain in it (a deleted domain included), or another project’s (not_found)

Problem (application/problem+json)

409

The project is deleted (conflict)

Problem (application/problem+json)

429

The key is over its rate limit, api.rate_limit_per_minute requests a minute on this node (rate_limited)

Header	Type	Description
`Retry-After`	integer	Seconds until the key’s next request passes; rounded up.

Problem (application/problem+json)

504

Postwind’s storage did not answer within its time limit (storage_timeout). A change the request makes may still take effect: check before repeating it. A repeat with the same Idempotency-Key never runs it twice: it is 409 idempotency_key_in_progress until the key’s 24 h end

Problem (application/problem+json)

bashRequest

# set POSTWIND_URL, POSTWIND_KEY and the ids first
curl -X DELETE "$POSTWIND_URL/api/v1/projects/$PROJECT_ID/domains/$DOMAIN_ID" \
  -H "Authorization: Bearer $POSTWIND_KEY"

MCP tool `delete_sending_domain` requires confirm

Call it: when a domain is no longer sent from.
Needs: an admin key with project_id, or a project key with scope write (its own project; the argument is ignored), the domain’s id, and confirm: true; without it the call changes nothing and tells what it would do.
Returns: outcome (would_delete, deleted), effect in words and the domain as get_sending_domain returns it after the call (null once deleted; a second call is not_found); the API’s DELETE /api/v1/projects/{project_id}/domains/{domain_id} answers 204.

jsontools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_sending_domain",
    "arguments": {
      "domain_id": "<domain_id>",
      "confirm": false
    }
  }
}

Open the tool page