---
title: "Delete a subscription"
method: DELETE
path: "/spaces/{spaceId}/subscriptions/{subscriptionId}"
tags: ["Manage Subscriptions"]
---

# Delete a subscription

`DELETE /spaces/{spaceId}/subscriptions/{subscriptionId}`

Deletes a subscription configuration.

## Path parameters

- `spaceId` string, required
- `subscriptionId` string, required

## Response `200`

The subscription

- Subscription — A subscription object that contains notification information.
  - `id` string — The uniques identifier for the subscription.
  - `source` string — The source for the subscribed notification (usually the space).
  - `destination` string — The destination for the subscribed notification.
  - `config` SubscriptionConfig — The subscription configuration.
    - `type` 'PER_FEATURE' | 'PER_TRANSACTION' | 'CONTENT_CHANGE' — The type of subscribed notification.
    - `params` object — The additional parameters of the subscription config
  - `status` object — The status of the subscription.
    - `state` string — The state of the subscription.
    - `stateReason` string — The reason for the current state.

## Other responses

- `400` — Malformed or Bad Request.
- `401` — Unauthorized to perform the request.
- `403` — Forbidden request. Insufficient rights to perform the request.
- `404` — Not found.
- `409` — An error response which indicates a conflict.

## Changes

- **2023-10-27** `cc1e76ffdd68` — 1 info
  - added the non-success response with the status `409`
- **2023-07-03** `fb8e107462aa` — 1 warning, 1 info
  - removed the optional property `filter` from the response with the `200` status
  - removed the non-success response with the status `409`

[Change history](https://skmtc.dev/here/apis/here-xyz-hub/changes/spaces/:spaceId/subscriptions/:subscriptionId/delete.md)

---

[API](https://skmtc.dev/here/apis/here-xyz-hub.md) · [All operations](https://skmtc.dev/here/apis/here-xyz-hub/llms.txt) · [OpenAPI document](https://skmtc.dev/here/apis/here-xyz-hub/revisions/a5a97b4943e2?raw)