Get MyTopics list

Method

GET

URL

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

Scope

my

URL parameters

Name Type Description
spaceKey String Space key

Response Example

{
    "pinnedTopics": [
        {
            "topic": {
                "id": 4483,
                "name": "Design",
                "description": "All about the world of visual design which include app ui/ux, website, news, tips and occasional banter among designers. Oh, and don't forget the weekend together.\n\nSome housekeeping:\n  1. Share your work and comment on others' work in a nice manners.\n  2. Report any issue to @Stefanie\n  3. Have fun typetalkin'! https://typetalk.com\n\nNote that this topic is open to everyone in the team!",
                "suggestion": "Design",
                "isDirectMessage": false,
                "lastPostedAt": "2018-09-25T04:42:47Z",
                "createdAt": "2017-03-21T20:04:45Z",
                "updatedAt": "2018-09-19T06:02:29Z"
            },
            "unread": {
                "topicId": 4483,
                "postId": 167373,
                "count": 0,
                "isOverCountLimit": false
            },
            "createdAt": "2018-09-25T09:42:49Z"
        }
    ],
    "joinedTopics": [
        {
            "topic": {
                "id": 6250,
                "name": "New project A",
                "description": "All about the project A",
                "suggestion": "New project A",
                "isDirectMessage": false,
                "lastPostedAt": null,
                "createdAt": "2018-09-25T09:43:56Z",
                "updatedAt": "2018-09-25T09:43:56Z"
            },
            "unread": {
                "topicId": 6250,
                "postId": 167376,
                "count": 0,
                "isOverCountLimit": false
            },
            "createdAt": "2018-09-25T09:43:56Z"
        }
    ],
    "myTopicGroups": [
        {
            "myTopicGroup": {
                "id": 1638,
                "name": "Important",
                "sortType": "recent",
                "isMuted": false
            },
            "myTopics": []
        },
        {
            "myTopicGroup": {
                "id": 1639,
                "name": "Marketing",
                "sortType": "recent",
                "isMuted": false
            },
            "myTopics": [
                {
                    "topic": {
                        "id": 3538,
                        "name": "Marketing",
                        "description": "",
                        "suggestion": "Marketing",
                        "isDirectMessage": false,
                        "lastPostedAt": "2017-11-13T22:19:49Z",
                        "createdAt": "2016-01-28T02:29:24Z",
                        "updatedAt": "2017-11-13T17:42:09Z"
                    },
                    "unread": {
                        "topicId": 3538,
                        "postId": 160926,
                        "count": 0,
                        "isOverCountLimit": false
                    },
                    "createdAt": "2018-09-21T02:23:11Z"
                }
            ]
        },
        {
            "myTopicGroup": {
                "id": 1642,
                "name": "Design",
                "sortType": "recent",
                "isMuted": false
            },
            "myTopics": [
                {
                    "topic": {
                        "id": 6196,
                        "name": "Visual Design",
                        "description": "",
                        "suggestion": "Visual Design",
                        "isDirectMessage": false,
                        "lastPostedAt": "2018-09-18T10:15:39Z",
                        "createdAt": "2018-09-10T02:21:46Z",
                        "updatedAt": "2018-09-10T02:21:46Z"
                    },
                    "unread": {
                        "topicId": 6196,
                        "postId": 167303,
                        "count": 0,
                        "isOverCountLimit": false
                    },
                    "createdAt": "2018-09-19T05:02:16Z"
                },
                {
                    "topic": {
                        "id": 6199,
                        "name": "Announcements for Designers",
                        "description": "",
                        "suggestion": "Announcements for Designers",
                        "isDirectMessage": false,
                        "lastPostedAt": null,
                        "createdAt": "2018-09-10T02:24:16Z",
                        "updatedAt": "2018-09-10T02:24:16Z"
                    },
                    "unread": {
                        "topicId": 6199,
                        "postId": 167206,
                        "count": 0,
                        "isOverCountLimit": false
                    },
                    "createdAt": "2018-09-19T05:02:30Z"
                },
                {
                    "topic": {
                        "id": 6198,
                        "name": "UX Team",
                        "description": "",
                        "suggestion": "UX Team",
                        "isDirectMessage": false,
                        "lastPostedAt": null,
                        "createdAt": "2018-09-10T02:23:40Z",
                        "updatedAt": "2018-09-10T02:23:40Z"
                    },
                    "unread": {
                        "topicId": 6198,
                        "postId": 167206,
                        "count": 0,
                        "isOverCountLimit": false
                    },
                    "createdAt": "2018-09-19T05:02:40Z"
                },
                {
                    "topic": {
                        "id": 6197,
                        "name": "Mondrian Website",
                        "description": "",
                        "suggestion": "Mondrian Website",
                        "isDirectMessage": false,
                        "lastPostedAt": null,
                        "createdAt": "2018-09-10T02:22:35Z",
                        "updatedAt": "2018-09-10T02:22:35Z"
                    },
                    "unread": {
                        "topicId": 6197,
                        "postId": 167206,
                        "count": 0,
                        "isOverCountLimit": false
                    },
                    "createdAt": "2018-09-19T05:03:23Z"
                },
                {
                    "topic": {
                        "id": 6195,
                        "name": "Designers",
                        "description": "",
                        "suggestion": "Designers",
                        "isDirectMessage": false,
                        "lastPostedAt": null,
                        "createdAt": "2018-09-10T02:21:20Z",
                        "updatedAt": "2018-09-10T02:21:20Z"
                    },
                    "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).