Custom hostnames
Claim a custom hostname. Platform hosts are refused (422); a domain of another organization or account is 409; 200 when this organization already has it. Honours Idempotency-Key. (scope: sites:write)
POST
bearerAuthheader
AuthorizationBearer <token>API key as Bearer token
application/json- body
domain*stringScheme, path and port are stripped.
Length
3 <= length <= 253target?stringDefault store when the organization has a store, else tenant (the whole tenant host).
Value in
"store""site""tenant"site_id?stringStore to bind (store/site targets).
Format
uuidOK
application/json- response
data*error*nullcurl -X POST "https://example.com/custom-hostnames" \ -H "Content-Type: application/json" \ -d '{ "domain": "string" }'{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "domain": "string", "created": true }, "error": null}Pause or resume tracking a SaaS subscription. Honours Idempotency-Key. (scope: costs:write) PATCH
Previous Page
Release the Cloudflare custom hostname, then delete the row; if Cloudflare refuses, the row is kept as delete_failed and the call answers 502 (retry). Honours Idempotency-Key. (scope: sites:write) DELETE
Next Page