curl -X DELETE https://api.gork.email/v1/domains/dom_1a2b3c4d5e6f \
-H "Authorization: Bearer gork_live_YOUR_API_KEY"
import { Gork } from "@gork/sdk"
const gork = new Gork({ apiKey: process.env.GORK_API_KEY })
await gork.domains.delete("dom_1a2b3c4d5e6f")
import requests, os
res = requests.delete(
"https://api.gork.email/v1/domains/dom_1a2b3c4d5e6f",
headers={"Authorization": f"Bearer {os.getenv('GORK_API_KEY')}"},
)
{
"data": {
"id": "dom_1a2b3c4d5e6f",
"status": "deleted"
}
}
Domains
Delete Domain
Remove a custom domain from your organization.
DELETE
/
v1
/
domains
/
{id}
curl -X DELETE https://api.gork.email/v1/domains/dom_1a2b3c4d5e6f \
-H "Authorization: Bearer gork_live_YOUR_API_KEY"
import { Gork } from "@gork/sdk"
const gork = new Gork({ apiKey: process.env.GORK_API_KEY })
await gork.domains.delete("dom_1a2b3c4d5e6f")
import requests, os
res = requests.delete(
"https://api.gork.email/v1/domains/dom_1a2b3c4d5e6f",
headers={"Authorization": f"Bearer {os.getenv('GORK_API_KEY')}"},
)
{
"data": {
"id": "dom_1a2b3c4d5e6f",
"status": "deleted"
}
}
Deletes a custom domain registration from your organization. Only a domain owned by your organization can be deleted — anything else returns
404 domain_not_found, so membership cannot be probed.
Headers
string
required
Bearer token formatted as
Bearer gork_live_.... Requires the domains:write scope.Path parameters
string
required
The domain ID (
dom_...).Inboxes provisioned on a deleted domain stop receiving and sending mail for that domain. Deactivate or migrate those inboxes first.
curl -X DELETE https://api.gork.email/v1/domains/dom_1a2b3c4d5e6f \
-H "Authorization: Bearer gork_live_YOUR_API_KEY"
import { Gork } from "@gork/sdk"
const gork = new Gork({ apiKey: process.env.GORK_API_KEY })
await gork.domains.delete("dom_1a2b3c4d5e6f")
import requests, os
res = requests.delete(
"https://api.gork.email/v1/domains/dom_1a2b3c4d5e6f",
headers={"Authorization": f"Bearer {os.getenv('GORK_API_KEY')}"},
)
{
"data": {
"id": "dom_1a2b3c4d5e6f",
"status": "deleted"
}
}
| Code | HTTP | Meaning |
|---|---|---|
domain_not_found | 404 | No domain with this ID exists in your organization. |