Get messages by tag
Get all messages attached to a particular tag.
Method
GET
URL
https://typetalk.com/api/v1/topics/:topicId/talks/:talkId/posts
Scope
topic.read
URL parameters
| Name | Type | Description |
|---|---|---|
| topicId | Number | Topic ID |
| talkId | Number | Tag ID |
Query parameters
| Name | Type | Description |
|---|---|---|
| count (Optional) | Number | default value: 20, maximum: 200 |
| from (Optional) | Number | references Post ID |
| direction (Optional) | String | “backward” or “forward” |
Response Example
{
"mySpace": {
"space": {
"key": "abcdefghij",
"name": "Joe Tech Inc.",
"enabled": true,
"imageUrl": "https://apps.nulab.com/spaces/abcdefghij/photo/large"
},
"myRole": "ADMIN",
"isPaymentAdmin": true,
"myPlan": {
"plan": {
"key": "typetalk.free",
"name": "Free Plan",
"limitNumberOfUsers": 10,
"limitTotalAttachmentSize": 1073741824
},
"enabled": true,
"trial": null,
"numberOfUsers": 6,
"totalAttachmentSize": 0,
"createdAt": "2016-01-10T02:32:29Z",
"updatedAt": "2016-12-21T10:12:18Z"
}
},
"topic": {
"id": 208,
"name": "IT Peeps",
"description": "",
"suggestion": "IT Peeps",
"isDirectMessage": false,
"lastPostedAt": "2016-12-21T10:12:02Z",
"createdAt": "2014-06-10T02:32:29Z",
"updatedAt": "2014-06-10T02:32:29Z"
},
"directMessage": null,
"talk": {
"id": 900,
"topicId": 208,
"name": "About us",
"suggestion": "About us",
"createdAt": "2014-07-02T03:42:29Z",
"updatedAt": "2014-07-02T03:52:29Z",
"backlog": null
},
"posts": [
{
"id": 305,
"topicId": 208,
"replyTo": null,
"message": "And I'm a 32 year old IT-man who works in a basement. Word.",
"account": {
"id": 104,
"name": "cooper",
"fullName": "CooperDaChopper",
"suggestion": "CooperDaChopper",
"imageUrl": "https://typetalk.com/accounts/104/profile_image.png?t=1403922749000",
"isBot": false,
"createdAt": "2014-06-28T02:32:29Z",
"updatedAt": "2014-06-28T02:32:29Z"
},
"mention": null,
"attachments": [],
"likes": [],
"talks": [
{
"id": 901,
"topicId": 208,
"name": "2nd talk",
"suggestion": "2nd talk",
"createdAt": "2014-07-02T03:52:29Z",
"updatedAt": "2014-07-02T03:55:29Z",
"backlog": null
},
{
"id": 900,
"topicId": 208,
"name": "About us",
"suggestion": "About us",
"createdAt": "2014-07-02T03:42:29Z",
"updatedAt": "2014-07-02T03:52:29Z",
"backlog": null
}
],
"links": [],
"createdAt": "2014-06-30T14:32:29Z",
"updatedAt": "2014-06-30T14:32:29Z"
},
{
"id": 306,
"topicId": 208,
"replyTo": 305,
"message": "Oh. What time of the month? The weekend?",
"account": {
"id": 100,
"name": "jessica",
"fullName": "Jessica Fitzherbert",
"suggestion": "Jessica Fitzherbert",
"imageUrl": "https://typetalk.com/accounts/100/profile_image.png?t=1403577149000",
"isBot": false,
"createdAt": "2014-06-24T02:32:29Z",
"updatedAt": "2014-06-24T02:32:29Z"
},
"mention": null,
"attachments": [],
"likes": [
{
"id": 403,
"postId": 306,
"topicId": 208,
"comment": null,
"account": {
"id": 101,
"name": "ahorowitz",
"fullName": "AHorowitz",
"suggestion": "AHorowitz",
"imageUrl": "https://typetalk.com/accounts/101/profile_image.png?t=1403663549000",
"isBot": false,
"createdAt": "2014-06-25T02:32:29Z",
"updatedAt": "2014-06-25T02:32:29Z"
},
"createdAt": "2016-12-21T01:11:42Z"
},
{
"id": 404,
"postId": 306,
"topicId": 208,
"comment": null,
"account": {
"id": 102,
"name": "moss",
"fullName": "Moss",
"suggestion": "Moss",
"imageUrl": "https://typetalk.com/accounts/102/profile_image.png?t=1403749949000",
"isBot": false,
"createdAt": "2014-06-26T02:32:29Z",
"updatedAt": "2014-06-26T02:32:29Z"
},
"createdAt": "2016-12-21T01:11:42Z"
},
{
"id": 405,
"postId": 306,
"topicId": 208,
"comment": null,
"account": {
"id": 103,
"name": "stefhull",
"fullName": "StefHull",
"suggestion": "StefHull",
"imageUrl": "https://typetalk.com/accounts/103/profile_image.png?t=1403836349000",
"isBot": false,
"createdAt": "2014-06-27T02:32:29Z",
"updatedAt": "2014-06-27T02:32:29Z"
},
"createdAt": "2016-12-21T01:11:42Z"
},
{
"id": 406,
"postId": 306,
"topicId": 208,
"comment": null,
"account": {
"id": 104,
"name": "cooper",
"fullName": "CooperDaChopper",
"suggestion": "CooperDaChopper",
"imageUrl": "https://typetalk.com/accounts/104/profile_image.png?t=1403922749000",
"isBot": false,
"createdAt": "2014-06-28T02:32:29Z",
"updatedAt": "2014-06-28T02:32:29Z"
},
"createdAt": "2016-12-21T01:11:42Z"
},
{
"id": 407,
"postId": 306,
"topicId": 208,
"comment": null,
"account": {
"id": 105,
"name": "brad",
"fullName": "BradMarshalls",
"suggestion": "BradMarshalls",
"imageUrl": "https://typetalk.com/accounts/105/profile_image.png?t=1404009149000",
"isBot": false,
"createdAt": "2014-06-29T02:32:29Z",
"updatedAt": "2014-06-29T02:32:29Z"
},
"createdAt": "2016-12-21T01:11:42Z"
}
],
"talks": [
{
"id": 900,
"topicId": 208,
"name": "About us",
"suggestion": "About us",
"createdAt": "2014-07-02T03:42:29Z",
"updatedAt": "2014-07-02T03:52:29Z",
"backlog": null
}
],
"links": [],
"createdAt": "2014-07-01T01:32:29Z",
"updatedAt": "2014-07-01T01:32:29Z"
}
],
"hasNext": 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).