Contents

Get topic message

Get a message in a topic.

Method

GET

URL

https://typetalk.com/api/v1/topics/:topicId/posts/:postId

Scope

topic.read

URL parameters

NameTypeDescription
topicIdNumberTopic ID
postIdNumberPost ID

Response Example

{
    "mySpace": {
        "space": {
            "key": "xxxxxx",
            "name": "Awesome Tech Inc.",
            "enabled": true,
            "imageUrl": "https://apps.nulab.com/spaces/xxxxxxx/photo/large"
        },
        "myRole": "ADMIN",
        "isPaymentAdmin": true,
        "invitableRoles": [
            "ADMIN",
            "USER",
            "GUEST"
        ],
        "myPlan": {
            "plan": {
                "key": "typetalk.standard10",
                "name": "Standard 10 Users",
                "limitNumberOfUsers": 10,
                "limitNumberOfAllowedAddresses": 10,
                "limitTotalAttachmentSize": 10737418240
            },
            "enabled": true,
            "trial": null,
            "numberOfUsers": 4,
            "numberOfAllowedAddresses": 0,
            "totalAttachmentSize": 14356,
            "createdAt": "2016-01-27T09:37:27Z",
            "updatedAt": "2018-09-25T09:43:56Z"
        }
    },
    "team": null,
    "topic": {
        "id": 4829,
        "name": "Coffee shop",
        "suggestion": "Coffee shop",
        "isDirectMessage": false,
        "lastPostedAt": "2018-11-06T07:56:42Z",
        "createdAt": "2017-11-13T22:27:21Z",
        "updatedAt": "2017-12-21T02:41:00Z",
        "description": "A topic for getting off-topic"
    },
    "post": {
        "id": 160931,
        "topicId": 4829,
        "replyTo": 160930,
        "message": "@Stefanie :dizzy: thank you for making my dreams come true https://media.giphy.com/media/bAlYQOugzX9sY/giphy.gif",
        "account": {
            "id": 2497,
            "name": "Will",
            "fullName": "Will",
            "suggestion": "Will",
            "imageUrl": "https://typetalk.com/accounts/2497/profile_image.png?t=1510596200433",
            "isBot": false,
            "createdAt": "2016-01-27T09:54:48Z",
            "updatedAt": "2018-09-28T20:22:05Z"
        },
        "mention": null,
        "attachments": [],
        "likes": [],
        "talks": [
            {
                "id": 2172,
                "topicId": 4829,
                "name": "FOOD",
                "suggestion": "FOOD",
                "createdAt": "2017-11-13T22:38:14Z",
                "updatedAt": "2017-11-13T22:38:14Z",
                "backlog": null
            }
        ],
        "links": [
            {
                "id": 3550,
                "url": "https://media.giphy.com/media/bAlYQOugzX9sY/giphy.gif",
                "contentType": "text/html",
                "title": "Cookie Monster GIF - Find & Share on GIPHY",
                "description": "Discover & share this Cookie Monster GIF with everyone you know. GIPHY is how you search, share, discover, and create GIFs.",
                "imageUrl": "https://media.giphy.com/media/bAlYQOugzX9sY/200.gif",
                "embed": {
                    "width": 320,
                    "author_url": "https://giphy.com/",
                    "title": "Cookie Monster GIF - Find & Share on GIPHY",
                    "url": "https://media.giphy.com/media/bAlYQOugzX9sY/giphy.gif",
                    "type": "photo",
                    "provider_name": "GIPHY",
                    "provider_url": "https://giphy.com/",
                    "author_name": "GIPHY",
                    "height": 180
                },
                "createdAt": "2017-11-13T22:35:19Z",
                "updatedAt": "2018-08-18T02:49:34Z"
            }
        ],
        "createdAt": "2017-11-13T22:35:18Z",
        "updatedAt": "2017-11-13T22:35:18Z"
    },
    "replies": [
        {
            "id": 160930,
            "topicId": 4829,
            "replyTo": null,
            "message": "@all I made a few too many batches of chocolate chip cookies last night (a travesty, I know!), so I brought some in to share. They're in the kitchen! :cookie: :cookie: :cookie: :cookie: :cookie: ",
            "account": {
                "id": 2498,
                "name": "Stefanie",
                "fullName": "Stefanie",
                "suggestion": "Stefanie",
                "imageUrl": "https://typetalk.com/accounts/2498/profile_image.png?t=1453891479138",
                "isBot": false,
                "createdAt": "2016-01-27T09:55:09Z",
                "updatedAt": "2018-08-18T01:42:19Z"
            },
            "mention": {
                "id": 16415,
                "readAt": "2017-11-14T07:36:56Z"
            },
            "attachments": [],
            "likes": [],
            "talks": [
                {
                    "id": 2172,
                    "topicId": 4829,
                    "name": "FOOD",
                    "suggestion": "FOOD",
                    "createdAt": "2017-11-13T22:38:14Z",
                    "updatedAt": "2017-11-13T22:38:14Z",
                    "backlog": null
                }
            ],
            "links": [],
            "createdAt": "2017-11-13T22:32:27Z",
            "updatedAt": "2017-11-13T22:32:27Z"
        }
    ],
    "exceedsAttachmentLimit": false,
    "isPostEnabled": true
}

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