---
title: "Delete Subscription"
method: DELETE
path: "/api/platform/v1/subscriptions/{id}"
tags: ["workflows"]
---

# Delete Subscription

`DELETE /api/platform/v1/subscriptions/{id}`

## Request

- Base URL: `https://docs.amdahl.ai`
- URL: `https://docs.amdahl.ai/api/platform/v1/subscriptions/{id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Permanently remove a Subscription so its event source stops firing agents, taking its fire history with it. Use when the user no longer wants the event trigger at all. Chats and documents earlier fires produced are untouched. Prefer disabling (subscriptions.update enabled=false) when the user may want it back.

## Path parameters

- `id` string, required: The subscription id to delete.

## Response `200`

OK

- object
  - `data` unknown

## Other responses

- `400`: Invalid input - failed schema validation
- `401`: Authentication required
- `403`: Forbidden - missing scope or role
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/amdahl/apis/amdahl-platform-api.md) · [All operations](https://skmtc.dev/amdahl/apis/amdahl-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/amdahl/apis/amdahl-platform-api/revisions/d4eee33e2472?raw)