---
title: "Delete Topic"
method: DELETE
path: "/api/v1/topics/{topic_id}"
tags: ["Basics"]
---

# Delete Topic

`DELETE /api/v1/topics/{topic_id}`

Soft-deletes a topic. By default its prompts are kept: they stay active, keep their history, remain grouped under the deleted topic in the app, and can be re-categorized later. Pass `delete_prompts=true` to also soft-delete every active prompt in the topic (they stop generating responses). Reversible: creating a topic with the same name restores it and its prompt grouping.

## Path parameters

- `topic_id` string, uuid, required

## Query parameters

- `website_id` string, uuid, required
- `delete_prompts` 'true' | 'false'

## Response `200`

Topic deleted

- object
  - `success` true, required
  - `name` string, required — Name of the deleted topic.
  - `deleted_prompt_count` integer, required — Number of prompts soft-deleted alongside the topic (0 unless delete_prompts=true).

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - You don't have access to this website
- `404` — Not found - Topic not found, deleted, or on another website
- `500` — Internal server error

---

[API](https://skmtc.net/athenahq/apis/athenahq-api.md) · [All operations](https://skmtc.net/athenahq/apis/athenahq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/athenahq/athenahq-api/versions/6c5d71622cb9/schema)