POST/bots/{botId}/channels

Creates a message room with a specified bot included.
The message room ID returned after the bot creation is used to send messages or to get members who belong to the message room with the bot included.

Authorization

oauth2

OAuth 2.0 authentication.
For more information, see Authentication and Authorization.

Scope

bot.message
bot

HTTP Request

POSThttps://www.worksapis.com/v1.0/bots/{botId}/channels

Path Parameters

ParameterTypeDescription
botId integer 

Bot ID


required
example : 2000001
format : int64 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 
Content-Type string 

application/json


required
example : application/json 

Request Body

PropertyTypeDescription
members array (string) 

List of members to invite to the message room


required
minItems : 1
maxItems : 100
uniqueItems : true 
title string 

Message room name


maxLength : 1000 

Request Example

example

1{2  "members": [3    "d191e339-3299-44e6-7a44-04d9cb01a5e0"4  ],5  "title": "Example title"6}

Response

HTTP 201

OK

PropertyTypeDescription
channelId string 

Message room ID


required 
title string 

Message room name


maxLength : 1000 

Response Example

example

1{2  "channelId": "12345a12-b12c-12d3-e123fghijkl",3  "title": "Example title"4}