# Revoke Push Devices

> Stop pushes to registrations using their revocation secrets. Idempotent.

Canonical URL: https://docs.botyard.io/docs/api/push-registrations/revoke_push_devices_v1_public_push_registrations_revoke_post

`POST /v1/public/push-registrations/revoke`

Stop pushes to registrations using their revocation secrets. Idempotent.

## Request body

`application/json`: PushRevocationsRequest (required)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `revocations` | array of PushRevocation | yes | Registrations to revoke, each at most once. All-or-nothing: if any pair does not match, nothing is revoked and the response does not say which. |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| `204` | Successful Response |  |
| `default` | RFC 9457 Problem Details error response | ProblemDetails |

Full schemas: operation `revoke_push_devices_v1_public_push_registrations_revoke_post` in the OpenAPI spec at https://api.botyard.io/openapi.json.