View all topics

See all participating topics in the organization.

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).