List topics

Topics your organization uses to tag Conversations, with their parent Topics.

GET https://cotlet.dev/api/v1/gladly/topics

read

Returns every enabled Topic with its ID and parent. Nested Topics show as parent > child, for example Exchange > Size. The agent only uses Topics from this list. Topics are created by administrators in Gladly, not by this tool.

Parameters

No parameters.

Request

cURL
curl https://cotlet.dev/api/v1/gladly/topics \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("gladly", "list_topics")
Node.js
const result = await cotlet.call('gladly', 'list_topics');
CLI
cotlet call gladly list_topics

Example response

JSON

{
  "topics": [
    {
      "topic_id": "Z_Oto7j-Sy2DlQdnZBDdDw",
      "name": "Order Status",
      "parent": null
    },
    {
      "topic_id": "8eiDakrnTgKa3HIxtgV5OA",
      "name": "Damaged Merchandise",
      "parent": "Order Return"
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.