v1

latestOpenAPI 3.0.0Apache 2.02026-07-179012215.4 KB
topic

Create new topic

Logged in user can create a new topic

post/api/users/:userId/topics

Path parameters

userIdstring required

logged in users id

Request body

visibility'public' | 'private'
categoriesstring[]
hashtagstring nullable
endsAtstring timestamp nullable
sourcePartnerObjectIdstring

related object id on partner

Example request

{
  "hashtag": "banana",
  "endsAt": "2018-08-06T04:11:41.568Z"
}

Response

New topic created successfully

Example response

{
  "status": {
    "code": 20000
  },
  "data": {
    "id": "c2eb6752-7d88-4153-93ae-fe47aee26573",
    "title": "My topic title",
    "description": "<html><head></head><body><h1>My topic title</h1></body></html>",
    "creator": {
      "name": "John Smith"
    },
    "endsAt": "2018-08-06T04:11:41.568Z",
    "hashtag": "banana",
    "createdAt": "2018-08-06T04:11:41.568Z",
    "updatedAt": "2018-08-06T04:11:41.568Z"
  }
}