---
title: "Delete subscription"
method: DELETE
path: "/apps/{app_id}/subscriptions/{subscription_id}"
---

# Delete subscription

`DELETE /apps/{app_id}/subscriptions/{subscription_id}`

Delete a specific subscription by its subscription_id. This stops messages from being sent to that subscription but does not prevent future subscriptions with the same token.

## Path parameters

- `app_id` string, required
- `subscription_id` string, required

## Response `202`

202

- object

## Other responses

- `400` — 400
- `403` — 403
- `404` — 404
- `429` — 429
- `503` — Service temporarily unavailable. Retry after a short backoff. The body may be empty or non-JSON in some failure modes.

---

[API](https://skmtc.net/onesignal/apis/api-onesignal-com.md) · [All operations](https://skmtc.net/onesignal/apis/api-onesignal-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onesignal/api-onesignal-com/versions/0fc223f7e338/schema)
