Create talk

Method

POST

URL

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

Scope

topic.write

URL parameters

Name Type Description
topicId Number Topic ID

Form parameters

Name Type Description
talkName String Talk name ( max 64 characters )
postIds[0], postIds[1] …. (Optional) Number Post IDs that you want to add to the talk

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 text formatted as JSON, and include ETag. If you call an API with If-None-Match header, the server returns a 304 status code when the data is not changed. The date and time format is ISO 8601 and timezone is UTC (eg. 2014-01-09T06:20:08Z).