Account

Deactivate a device

DELETE/account/devices/{id}
account:writedelete_account_deviceDestructiveIdempotent

Stops push notifications to the device by marking it inactive, and returns 204. It does not end any session or revoke any token. It cannot be undone through the API, but the device is kept and the app can register it again. An unknown, malformed, already inactive or another user's device returns 404. It has no dry run. Emits no webhook.

Path parameters

  • idstring (uuid)Required#

    The device's id, a UUID, from GET /account/devices.

Responses

204

The device was deactivated.

401

Authentication failed. error.code is one of invalid_token, expired, revoked.

Error
403

Authorization failed. error.code is one of org_disabled, ip_blocked, missing_scope, scope_disabled, user_disabled.

Error
404

Resource not found (error.code = not_found).

Error
422

The request can't be processed (HTTP 422): validation_failed with one ErrorDetail per problem, or a code documented on the operation.

Error
429

Rate limit exceeded (error.code = rate_limited).

Error

Examples

curl -X DELETE https://your-org-domain/kong/core/api/v2/account/devices/{id}\
  -H "Authorization: Bearer $HELM_API_KEY"\
  -H "Content-Type: application/json"