Documentation
Remove an own domain
DELETE
/v1/domains/{domain}DomainsRemoves a domain that has no links on it (delete or move its links first; the answer is 409 with details.links otherwise). You can then remove the CNAME record.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string, in the path | required | The domain's id or its hostname. |
Example request
curl -s -X DELETE "https://snip.link/v1/domains/go.example.com" \ -H "Authorization: Bearer $SNIP_KEY"
Example response
{
"deleted": true
}Response fields
| Field | Type | Description |
|---|---|---|
deleted | true |
Errors
| Status | Meaning |
|---|---|
| 401 | The API key is missing, malformed or revoked. |
| 404 | No domain by that id or hostname in this account. |
| 409 | The domain still has links on it. |
| 429 | Either the key exceeded its requests-per-second limit (honor Retry-After), or a daily or plan quota is used up (details.reason). |