Get topics

Method

GET

URL

https://typetalk.com/api/v3/topics

Scope

my

Query parameters

Name Type Description
spaceKey String Space key
isArchived (Optional) Boolean Whether archives topic are. If it’s not specified, all topics.
onlyEditable (Optional) Boolean Whether topics which you have permissions to edit or delete. If it’s not specified, all topics.

Response Example

{
    "topics": [
        {
            "topic": {
                "id": 26095,
                "name": "Coffeeshop",
                "suggestion": "Coffeeshop",
                "isDirectMessage": false,
                "isArchived": false,
                "lastPostedAt": "2019-09-02T06:07:35Z",
                "ownerSpaceAccountId": 103,
                "createdAt": "2019-09-02T06:05:56Z",
                "updatedAt": "2019-09-02T06:05:56Z"
            },
            "unread": {
                "topicId": 26095,
                "postId": 176297,
                "count": 0,
                "isOverCountLimit": false
            }
        },
        {
            "topic": {
                "id": 6195,
                "name": "Designers",
                "suggestion": "Designers",
                "isDirectMessage": false,
                "isArchived": false,
                "lastPostedAt": "2019-07-01T09:09:06Z",
                "ownerSpaceAccountId": 103,
                "createdAt": "2018-09-10T02:21:20Z",
                "updatedAt": "2018-09-10T02:21:20Z"
            },
            "unread": {
                "topicId": 6195,
                "postId": 167206,
                "count": 0,
                "isOverCountLimit": false
            }
        }
    ]
}

All responses are formatted in JSON and include an ETag. If you call an API with an If-None-Match header, the server will return a 304 status code if the data is unchanged. The date and time format is ISO 8601, and the timezone is UTC (eg. 2014-01-09T06:20:08Z).