ATathenahq
Basics

Update Topic

Updates a topic's name and/or description. Only the supplied fields change. Renaming to a name already used by another active topic on the website returns 400. Renames don't affect metrics or prompt grouping — everything joins on the topic's id, not its name. Returns a before/after snapshot.

patch/api/v1/topics/{topic_id}

Request

  • Base URL
    https://api.athenahq.ai
  • Auth
    API key in header x-api-key

Path parameters

topic_idstring uuid required

The topic to update.

Request body

website_idstring uuid required

Website that owns the topic.

namestring

New topic name. Trimmed; blank rejected.

descriptionstring nullable

New topic description. Send null to clear.

Response

Topic updated

idstring uuid required
namestring required
descriptionstring nullable required

Changes

No recorded changes to this operation across all 3 revisions of this API.