---
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.
  - `filter` SubscriptionFilters — Filter criteria for subscription notifications.
    - `jsonPath` string — The JSON path expression to filter features on.
    - `spatialFilter` SpatialFilter — A spatial filter to filter features based on their geometric properties.
      - `geometry` Geometry — A Geometry object represents points, curves, and surfaces in coordinate space.
        - `type` string, required
        - `bbox` number[] — Describes the coordinate range of the GeoJSON object.
      - `radius` integer — Radius in meters which defines the diameter of the search request.
      - `clip` boolean — If set to true the features' geometries are clipped to the geometry of the tile, bounding box or input geometry. Default is false.

## 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

- **2026-03-04** `c9312a516dfc` — 1 warning, 1 info
  - removed the optional property `filter/jsonPaths` from the response with the `200` status
  - added the optional property `filter/jsonPath` to the response with the `200` status
- **2026-02-12** `d9e2b8df8c8a` — 1 info
  - added the optional property `filter` to the response with the `200` status
- **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-service-production.skmtc.workers.dev/v1/apis/here/here-xyz-hub/revisions/1c6c6a2bcac9/schema)