REST API: topics

Topics are agent-scoped resources. To start a curation job, read the agent's topics and their statistics. Then create, update, merge, or delete only the records that your policy selects. Keep the agent identifier separate from the topic identifier. Do not build a merge or a deletion from display text alone. Labels can look similar, and labels can change over time.

Use similar-topic results as a review aid, not an automatic merge instruction. In a safe workflow, you record the candidate topics, apply the merge, then read the list again before you proceed. Topic statistics have their own bounded query behavior and are not a substitute for all-conversation reporting. If your question is about performance across many conversations, use the Analytics guides instead.

Topic mutations require a trusted backend. Create and update need a write-capable key, while merge and delete require the stricter admin scope. Validate the outgoing payload against the generated reference. Show API validation errors to the operator. Keep enough context to undo an incorrect curation decision through your own process.