---
title: "Delete a plan"
method: POST
path: "/v1/plans.delete"
tags: ["plans"]
---

# Delete a plan

`POST /v1/plans.delete`

Deletes a plan by its ID.

Use this to permanently remove a plan. Plans with active customers cannot be deleted - archive them instead.

## Headers

- `x-api-version` string, required

## Request body

- object
  - `plan_id` string, required — The ID of the plan to delete.
  - `all_versions` boolean — If true, deletes all versions of the plan. Otherwise, only deletes the latest version.

## Response `200`

OK

- object
  - `success` boolean, required

---

[API](https://skmtc.net/useautumn/apis/autumn-api.md) · [All operations](https://skmtc.net/useautumn/apis/autumn-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/useautumn/autumn-api/revisions/29536933c0dc/schema)