curl -X DELETE "https://api.scanova.io/custom-domain/42/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
Custom Domains
Remove a custom domain
DELETE /custom-domain//
DELETE
/
custom-domain
/
{pk}
/
curl -X DELETE "https://api.scanova.io/custom-domain/42/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
Disconnects a custom domain from the account, on the Management API host (
A successful call returns
api.scanova.io), authenticated with your raw Management API key.
DELETE https://api.scanova.io/custom-domain/{pk}/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
Requires the
CUSTOM_DOMAIN_CAN_DELETE permission.integer
required
The domain’s
id.curl -X DELETE "https://api.scanova.io/custom-domain/42/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
204 No Content.
QR Codes must be unlinked first
If the domain is still linked to any QR Code — including trashed ones — this returns400 with {"error": ["This domain is linked to QR Code(s)... Delete permanently the QR Code(s) first..."]} instead of removing it. Permanently delete (not just trash) the linked QR Codes before retrying. 404 if pk isn’t a domain owned by this account.
Related
- Retrieve a custom domain — check for linked QR Codes before deleting.
- List custom domains — see what else is connected.
- Management API overview — the auth scheme and quota rules that apply to this endpoint.
Authorizations
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Path Parameters
Response
Domain removed.
Was this page helpful?