Get topics

Method

GET

URL

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

Scope

my

Query parameters

Name Type Description
spaceKey String Space key

Response Example

{
    "topics": [
        {
            "topic": {
                "id": 5446,
                "name": "test illo video",
                "suggestion": "test illo video",
                "isDirectMessage": false,
                "lastPostedAt": "2018-03-09T12:33:04Z",
                "createdAt": "2018-03-09T12:29:30Z",
                "updatedAt": "2018-03-09T12:29:30Z"
            },
            "favorite": true,
            "unread": {
                "topicId": 5446,
                "postId": 163520,
                "count": 0,
                "isOverCountLimit": false
            }
        },
        {
            "topic": {
                "id": 4829,
                "name": "Coffee shop",
                "suggestion": "Coffee shop",
                "isDirectMessage": false,
                "lastPostedAt": "2018-02-19T11:03:26Z",
                "createdAt": "2017-11-13T22:27:21Z",
                "updatedAt": "2017-12-21T02:41:00Z"
            },
            "favorite": true,
            "unread": {
                "topicId": 4829,
                "postId": 163086,
                "count": 0,
                "isOverCountLimit": false
            }
        },
        {
            "topic": {
                "id": 3538,
                "name": "Marketing",
                "suggestion": "Marketing",
                "isDirectMessage": false,
                "lastPostedAt": "2017-11-13T22:19:49Z",
                "createdAt": "2016-01-28T02:29:24Z",
                "updatedAt": "2017-11-13T17:42:09Z"
            },
            "favorite": false,
            "unread": {
                "topicId": 3538,
                "postId": 160926,
                "count": 0,
                "isOverCountLimit": false
            }
        },
        {
            "topic": {
                "id": 4828,
                "name": "Website Feedback",
                "suggestion": "Website Feedback",
                "isDirectMessage": false,
                "lastPostedAt": "2017-11-13T18:57:22Z",
                "createdAt": "2017-11-13T18:07:45Z",
                "updatedAt": "2017-11-13T18:13:55Z"
            },
            "favorite": true,
            "unread": {
                "topicId": 4828,
                "postId": 160924,
                "count": 0,
                "isOverCountLimit": false
            }
        },
        {
            "topic": {
                "id": 4483,
                "name": "Design",
                "suggestion": "Design",
                "isDirectMessage": false,
                "lastPostedAt": "2017-11-13T18:39:00Z",
                "createdAt": "2017-03-21T20:04:45Z",
                "updatedAt": "2018-02-19T06:58:35Z"
            },
            "favorite": true,
            "unread": {
                "topicId": 4483,
                "postId": 160915,
                "count": 0,
                "isOverCountLimit": false
            }
        },
        {
            "topic": {
                "id": 4457,
                "name": "All Company",
                "suggestion": "All Company",
                "isDirectMessage": false,
                "lastPostedAt": "2017-09-19T06:32:29Z",
                "createdAt": "2017-03-03T07:37:59Z",
                "updatedAt": "2017-03-21T21:14:21Z"
            },
            "favorite": true,
            "unread": {
                "topicId": 4457,
                "postId": 160020,
                "count": 0,
                "isOverCountLimit": false
            }
        },
        {
            "topic": {
                "id": 3540,
                "name": "Strategy",
                "suggestion": "Strategy",
                "isDirectMessage": false,
                "lastPostedAt": "2017-03-07T16:32:51Z",
                "createdAt": "2016-01-28T02:29:24Z",
                "updatedAt": "2017-11-13T17:41:49Z"
            },
            "favorite": false,
            "unread": {
                "topicId": 3540,
                "postId": 157928,
                "count": 0,
                "isOverCountLimit": false
            }
        },
        {
            "topic": {
                "id": 3536,
                "name": "IT",
                "suggestion": "IT",
                "isDirectMessage": false,
                "lastPostedAt": "2017-03-03T10:58:30Z",
                "createdAt": "2016-01-28T02:29:23Z",
                "updatedAt": "2017-11-13T17:39:01Z"
            },
            "favorite": true,
            "unread": {
                "topicId": 3536,
                "postId": 158388,
                "count": 0,
                "isOverCountLimit": false
            }
        },
        {
            "topic": {
                "id": 3539,
                "name": "UI/UX",
                "suggestion": "UI/UX",
                "isDirectMessage": false,
                "lastPostedAt": "2016-01-28T01:29:24Z",
                "createdAt": "2016-01-28T02:29:24Z",
                "updatedAt": "2016-01-28T02:29:24Z"
            },
            "favorite": true,
            "unread": {
                "topicId": 3539,
                "postId": 0,
                "count": 0,
                "isOverCountLimit": false
            }
        },
        {
            "topic": {
                "id": 3541,
                "name": "Dev",
                "suggestion": "Dev",
                "isDirectMessage": false,
                "lastPostedAt": "2016-01-27T23:29:24Z",
                "createdAt": "2016-01-28T02:29:24Z",
                "updatedAt": "2017-11-13T18:07:00Z"
            },
            "favorite": false,
            "unread": {
                "topicId": 3541,
                "postId": 0,
                "count": 0,
                "isOverCountLimit": false
            }
        },
        {
            "topic": {
                "id": 3542,
                "name": "Beer Brewing Club",
                "suggestion": "Beer Brewing Club",
                "isDirectMessage": false,
                "lastPostedAt": "2016-01-27T22:29:24Z",
                "createdAt": "2016-01-28T02:29:24Z",
                "updatedAt": "2017-03-21T21:13:44Z"
            },
            "favorite": true,
            "unread": {
                "topicId": 3542,
                "postId": 0,
                "count": 0,
                "isOverCountLimit": false
            }
        },
        {
            "topic": {
                "id": 3543,
                "name": "HR",
                "suggestion": "HR",
                "isDirectMessage": false,
                "lastPostedAt": "2016-01-27T21:29:24Z",
                "createdAt": "2016-01-28T02:29:24Z",
                "updatedAt": "2017-11-13T17:43:00Z"
            },
            "favorite": false,
            "unread": {
                "topicId": 3543,
                "postId": 0,
                "count": 0,
                "isOverCountLimit": false
            }
        },
        {
            "topic": {
                "id": 3544,
                "name": "Industry News",
                "suggestion": "Industry News",
                "isDirectMessage": false,
                "lastPostedAt": "2016-01-27T20:29:24Z",
                "createdAt": "2016-01-28T02:29:24Z",
                "updatedAt": "2017-11-13T17:43:28Z"
            },
            "favorite": false,
            "unread": {
                "topicId": 3544,
                "postId": 0,
                "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).