Topics Endpoint

Endpoints Explorer

This endpoint allows you to list the topics in your workspace.

Listing Topics

A GET returns the topics for your organization, most recent first.

uuid - the UUID of the topic (string).
name - the name of the topic (string).
counts - the counts of open and closed tickets with this topic (object).
system - whether this is a system topic that can't be modified (bool).
created_on - when this topic was created (datetime).

Example:

GET /api/v2/topics.json

Response:

{
    "next": null,
    "previous": null,
    "results": [
    {
        "uuid": "9a8b001e-a913-486c-80f4-1356e23f582e",
        "name": "Support",
        "counts": {"open": 12, "closed": 345},
        "system": false,
        "created_on": "2013-02-27T09:06:15.456"
    },
    ...

Adding o New Topic

By making a POST request with a unique name you can create a new topic.

name - the name of the topic to create (string)

Example:

POST /api/v2/topics.json
{
    "name": "Complaints"
}