---
title: "Delete a subscription and its stored runs"
method: DELETE
path: "/api/v1/pulse/{sub_id}"
tags: ["Pulse"]
---

# Delete a subscription and its stored runs

`DELETE /api/v1/pulse/{sub_id}`

## Request

- Base URL: `https://data.useplinth.com`
- URL: `https://data.useplinth.com/api/v1/pulse/{sub_id}`
- Auth: API key in header `X-API-Key`

Removes the subscription, its check state and every stored digest. There is no undo; pausing with `active: false` is the reversible form.

## Path parameters

- `sub_id` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `401`: No API key, or a key we do not recognize.
- `402`: The call allowance is spent, the account is inactive, or the endpoint needs a paid plan — the message says which, and names the period it resets on (daily on free and non-profit plans, monthly on Pro).
- `422`: Validation Error

---

[API](https://skmtc.dev/useplinth/apis/plinth-grants-api.md) · [All operations](https://skmtc.dev/useplinth/apis/plinth-grants-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useplinth/apis/plinth-grants-api/revisions/15273cd72ecf?raw)