Skip to main content

Delete Support Push Subscription

DELETE 

/api/support/push/subscriptions

Removes one of the signed-in user's devices. The browser unsubscribes locally first and then tells us, so the endpoint of the subscription being dropped is the whole body.

Required scope: support:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Always answers 204, whether or not there was anything to remove — calling it twice, or for a device that had already been cleaned up after the push service reported it gone, is a success, not a 404. A device belonging to somebody else is left untouched: an endpoint is not proof of who holds the device.

Request body

  • endpoint (string, required) — the endpoint of the device to remove, max 2000 characters

This endpoint does not require tenant context — a device is registered once and covers every tenant the caller works in.

Authentication: Bearer token with the support:write scope, or an authenticated session.

Request

Responses

No Content