Create tag

Create a tag.

Method

POST

URL

https://typetalk.com/api/v1/topics/:topicId/talks

Scope

topic.post

URL parameters

Name	Type	Description
topicId	Number	Topic ID

Form parameters

Name	Type	Description
talkName	String	Tag name ( max 255 characters )
postIds[0], postIds[1] … (Optional)	Number	Post IDs that you want to add to the tag

Response Example

{
  "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"
  },
  "talk": {
    "id": 902,
    "topicId": 208,
    "name": "Feedback new design",
    "suggestion": "Feedback new design",
    "createdAt": "2016-12-21T10:12:22Z",
    "updatedAt": "2016-12-21T10:12:22Z",
    "backlog": null
  },
  "postIds": [
    300,
    301
  ]
}

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