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.
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.
Authorization
apiKey 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
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" }}