---
title: "Delete topic"
method: DELETE
path: "/api/v1/models/{modelId}/topic/{topicName}"
tags: ["Models"]
---

# Delete topic

`DELETE /api/v1/models/{modelId}/topic/{topicName}`

## Path parameters

- `modelId` string, uuid, required — Model UUID
- `topicName` string, required — Topic name

## Query parameters

- `branch_id` string, uuid — Branch ID to use for branch-aware operations
- `mode` 'COMBINED' | 'MERGED' | 'EXTENSION' — Controls delete behavior to match IDE editing modes. COMBINED (default) adds the topic to deletedTopics if it exists in the parent model (prevents reappearing). MERGED behaves the same as COMBINED. EXTENSION hard-deletes the topic from the extension layer.

## Response `200`

Topic deleted successfully

- SuccessResponse
  - `success` boolean, required — Whether the operation was successful

## Other responses

- `401` — Authentication required
- `403` — Permission denied
- `404` — Model or topic not found

---

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