Delete topic

Delete a topic and all prompts inside it.

DELETE /v1/topics/{topicId}

Delete topic

cURL

curl --request DELETE \
  --url https://api.example.com/v1/topics/{topicId}

Permanently deletes a topic and all prompts it contains. Use with care — there is no undo.

Path parameters

topicId · string · required

Topic UUID.

Request

curl -s -X DELETE \
  -H "x-spotlight-api-key: YOUR_API_KEY" \
  "https://app.get-spotlight.com/api/v1/topics/TOPIC_ID"

Response

{
  "deleted": true,
  "remainingSlots": 100
}

This operation deletes all prompts under the topic. Historical analysis results that referenced those prompts are not deleted, but the prompts themselves will no longer be returned in future API calls.