# Revoke a storefront notification subscription (/api-reference/survey-channels/revokeSurveyPushSubscription)

`DELETE /v1/retention/push-subscriptions/{id}`

Base URL: `https://api.bitelio.com`

Merchant backend only, retention:view and retention:edit. Scoped to the authenticated project, contactId and subscription id; idempotent. Limit120 requests/minute shared perproject.

## Path parameters

- `id`: string (required)

## Request body

- `contactId`: string (required)

Example:

```json
{
  "contactId": "string"
}
```

## Responses

### `200` — Success

- `revoked`: boolean (required)

```json
{
  "revoked": false
}
```

### `400` — Invalid input or unavailable channel

### `401` — Secret API key required

### `403` — Required project permission is missing

### `429` — Project rate limit exceeded. Retry-After identifies the wait in seconds.

### `503` — Rate limiter temporarily unavailable; retry later.

## Example request

```bash
curl -X DELETE 'https://api.bitelio.com/v1/retention/push-subscriptions/{id}' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"contactId":"string"}'
```