CustomDomain Docs
ReferenceAPI referenceProvider accounts

Remove an account (the key must still be revoked at the provider)

revoke provider account: CustomDomain™ API reference in the provider accounts group. Covers request parameters, the request body, responses and error codes.

DELETE
/provider-accounts/{id}

Deletes CustomDomain™'s copy of the key and the account. Its domains stay connected and served, without continuous access; each domain's timeline records it. The answer says what that leaves: used_by is how many domains used the account, and revoke_url is the provider's page where the key itself is deleted. It deletes CustomDomain™'s copy only, for a key a person pasted as for a lasting API key the cloud browser's agent made: the key lives at the provider until it is deleted there (no provider documents an API that revokes one), and the application receives credential.removed for a key the agent made. Removing an account takes whoever manages it, like every other change to it: an admin, an owner or the member who connected it (can_manage), and for a key a customer's secure sign-in made, which no member connected, an admin or an owner. Anyone else, a viewer included, gets 403, and nothing is deleted or detached.

AuthorizationBearer <token>

Long-lived tenant API key, cd_live_… (production) or cd_test_… (staging, development), stored hashed. Keys created before the switch to cd_ start with sk_live_… / sk_test_… and are still accepted. Scoped to the owning application's tenant.

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/provider-accounts/string"
{  "id": "string",  "removed_here": true,  "revoke_at_provider": true,  "revoked": true,  "used_by": 0,  "domains_kept_connected": 0,  "revoke_url": "http://example.com"}
{  "code": "account_not_verifiable",  "title": "string",  "details": "string",  "challenge": {    "value": "string",    "bits": 1,    "expires_at": "2019-08-24T14:15:22Z"  }}
{  "code": "account_not_verifiable",  "title": "string",  "details": "string",  "challenge": {    "value": "string",    "bits": 1,    "expires_at": "2019-08-24T14:15:22Z"  }}
{  "code": "account_not_verifiable",  "title": "string",  "details": "string",  "challenge": {    "value": "string",    "bits": 1,    "expires_at": "2019-08-24T14:15:22Z"  }}