Skip to main content
DELETE
Delete a topic
Deletes the label and detaches it from prompts. Prompts and their retained answers are preserved. The operation requires no request body. Requires an active Business, Agency Business or Enterprise plan. Use an API token with write access enabled. See Writing data for idempotency, conditional requests and error handling.
string
required
Bearer token for your team.
string
required
Copy the complete ETag from the latest GET, including its quotes.
string
required
Workspace identifier. The workspace must belong to the token’s team.
string
required
Topic identifier within this workspace.

Response

Returns 200 with deleted: true and topicId. Deleting an already absent label in an accessible workspace also succeeds. For an existing label, a stale ETag returns 412 without deleting it.

Synthetic request and response

Use the ETag from Get a topic. This example assumes "4".

Errors

See Error codes for authentication, plan, idempotency and server errors. On 429, honor Retry-After; writes can return 503 SERVICE_UNAVAILABLE if the write limiter is unavailable.