Delete a topic

Delete a topic.

DELETEhttps://app.usenotix.dev/api/v1/topics/{topicId}

Needs a full access key. Sending access keys cannot call this. Key permissions lists the extra rules some calls have.

Delete a topic. It disappears from the API, the console and the preference page, and a campaign that targets it stops. Contacts' choices are kept: create a topic with the same name and the same default to bring it back with them. Refused with 409 while a scheduled, sending or paused campaign targets it.

Needs a full access key. Topics carry no domain, so a key limited to one domain may use them too. Read only, send-only and live AI keys answer 403 SCOPE_DENIED.

Path parameters

topicIdstringrequired

Headers

Authorizationstringrequired

Bearer followed by your API key.

Errors

404

No topic with this id in the team.

409

A scheduled, sending or paused campaign targets this topic.

Every error has the same shape. See all error codes.

curl -X DELETE "https://app.usenotix.dev/api/v1/topics/<topicId>" \
  -H "Authorization: Bearer $NOTIX_API_KEY"
Response200
{
  "id": "cm1x8f3k20001qz7v5b9d2e4a",
  "deleted": true
}
Open in ClaudeOpen in ChatGPT