Contents

Get my topics

Get your pinned topics, recently joined topics, and topic groups.

Method

GET

URL

https://typetalk.com/api/v1/spaces/:spaceKey/myTopics

Scope

my

URL parameters

NameTypeDescription
spaceKeyStringSpace key

Response Example

{
    "pinnedTopics": [
        {
            "topic": {
                "id": 4483,
                "name": "Design",
                "suggestion": "Design",
                "isDirectMessage": false,
                "lastPostedAt": "2018-09-25T04:42:47Z",
                "createdAt": "2017-03-21T20:04:45Z",
                "updatedAt": "2018-09-19T06:02:29Z"
            },
            "exTopicGroupId": 1642,
            "unread": {
                "topicId": 4483,
                "postId": 167373,
                "count": 0,
                "isOverCountLimit": false
            },
            "createdAt": "2018-09-25T09:42:49Z"
        }
    ],
    "joinedTopics": [
        {
            "topic": {
                "id": 6931,
                "name": "New project",
                "suggestion": "New project",
                "isDirectMessage": false,
                "lastPostedAt": null,
                "createdAt": "2018-11-09T00:35:59Z",
                "updatedAt": "2018-11-09T00:35:59Z"
            },
            "exTopicGroupId": null,
            "unread": {
                "topicId": 6931,
                "postId": 168021,
                "count": 0,
                "isOverCountLimit": false
            },
            "createdAt": "2018-11-09T00:35:59Z"
        }
    ],
    "myTopicGroups": [
        {
            "myTopicGroup": {
                "id": 1638,
                "name": "Important",
                "sortType": "recent",
                "isMuted": false
            },
            "myTopics": []
        },
        {
            "myTopicGroup": {
                "id": 1639,
                "name": "Marketing",
                "sortType": "recent",
                "isMuted": false
            },
            "myTopics": []
        },
        {
            "myTopicGroup": {
                "id": 1642,
                "name": "Design",
                "sortType": "recent",
                "isMuted": false
            },
            "myTopics": [
                {
                    "topic": {
                        "id": 6196,
                        "name": "Visual Design",
                        "suggestion": "Visual Design",
                        "isDirectMessage": false,
                        "lastPostedAt": "2018-09-28T10:46:10Z",
                        "createdAt": "2018-09-10T02:21:46Z",
                        "updatedAt": "2018-09-10T02:21:46Z"
                    },
                    "exTopicGroupId": null,
                    "unread": {
                        "topicId": 6196,
                        "postId": 167418,
                        "count": 0,
                        "isOverCountLimit": false
                    },
                    "createdAt": "2018-09-19T05:02:16Z"
                },
                {
                    "topic": {
                        "id": 6199,
                        "name": "Announcements for Designers",
                        "suggestion": "Announcements for Designers",
                        "isDirectMessage": false,
                        "lastPostedAt": null,
                        "createdAt": "2018-09-10T02:24:16Z",
                        "updatedAt": "2018-09-10T02:24:16Z"
                    },
                    "exTopicGroupId": null,
                    "unread": {
                        "topicId": 6199,
                        "postId": 167206,
                        "count": 0,
                        "isOverCountLimit": false
                    },
                    "createdAt": "2018-09-19T05:02:30Z"
                },
                {
                    "topic": {
                        "id": 6198,
                        "name": "UX Team",
                        "suggestion": "UX Team",
                        "isDirectMessage": false,
                        "lastPostedAt": null,
                        "createdAt": "2018-09-10T02:23:40Z",
                        "updatedAt": "2018-09-10T02:23:40Z"
                    },
                    "exTopicGroupId": null,
                    "unread": {
                        "topicId": 6198,
                        "postId": 167206,
                        "count": 0,
                        "isOverCountLimit": false
                    },
                    "createdAt": "2018-09-19T05:02:40Z"
                },
                {
                    "topic": {
                        "id": 6197,
                        "name": "Mondrian Website",
                        "suggestion": "Mondrian Website",
                        "isDirectMessage": false,
                        "lastPostedAt": null,
                        "createdAt": "2018-09-10T02:22:35Z",
                        "updatedAt": "2018-09-10T02:22:35Z"
                    },
                    "exTopicGroupId": null,
                    "unread": {
                        "topicId": 6197,
                        "postId": 167206,
                        "count": 0,
                        "isOverCountLimit": false
                    },
                    "createdAt": "2018-09-19T05:03:23Z"
                },
                {
                    "topic": {
                        "id": 6195,
                        "name": "Designers",
                        "suggestion": "Designers",
                        "isDirectMessage": false,
                        "lastPostedAt": null,
                        "createdAt": "2018-09-10T02:21:20Z",
                        "updatedAt": "2018-09-10T02:21:20Z"
                    },
                    "exTopicGroupId": null,
                    "unread": {
                        "topicId": 6195,
                        "postId": 167206,
                        "count": 0,
                        "isOverCountLimit": false
                    },
                    "createdAt": "2018-09-19T05:02:32Z"
                }
            ]
        },
        {
            "myTopicGroup": {
                "id": 1640,
                "name": "After Work",
                "sortType": "recent",
                "isMuted": false
            },
            "myTopics": []
        },
        {
            "myTopicGroup": {
                "id": 1641,
                "name": "Apps",
                "sortType": "recent",
                "isMuted": false
            },
            "myTopics": []
        }
    ],
    "favoritesOnboarding": 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).