DELETE /v1/extension/key
Disconnect the extension: revoke the key used for this request
Disconnect the extension: revoke the key used for this request
Revokes the API key in the Authorization header if it is an extension key (issued via /v1/extension/exchange); the revocation is written to the tenant audit log. Other keys get 403 not_extension_key and are revoked in Desk. After this call the key returns 401. Requires scope read:pricing (every extension key has it).
- Authentication: header
Authorization: Bearer rv_live_...(API keys and scopes) - Required scope:
read:pricing (every extension key has it)
openapi.json).Responses
200
The key is revoked.
application/json · Schema: ExtensionKeyRevoked
| Field | Type | Required | Description |
|---|---|---|---|
revoked | true | yes | |
key | object | yes | |
key.name | string | yes |
400
Invalid request parameters or body (code validation_error).
application/problem+json · Schema: Problem
401
Missing, malformed, unknown, revoked or expired API key (code unauthorized).
application/problem+json · Schema: Problem
403
Not an extension key, or the key lacks scope read:pricing.
application/problem+json · Schema: Problem
429
Rate limit exceeded for the tenant plan (code rate_limited). Wait Retry-After seconds.
application/problem+json · Schema: Problem