Sign in
latestOpenAPI 3.0.32026-08-2142130334.7 KB

0a94056fba48

Conversations

Create a channel

Creates a channel in the authenticated workspace. Same operation as the MCP create_conversation tool: channels are public unless access_control_type is "private", the caller always joins, and a name already used by an active channel returns 409 channel_name_conflict.

post/conversations

Request body

access_control_type'public' | 'private'

Channel visibility. Defaults to "public".

member_idsstring[]

Workspace member ids to include as initial channel members. The caller is always included.

namestring required

The channel name.

Example request

{
  "member_ids": [
    "01jzn7e61x3a7v9h2r7t2m3q4p"
  ]
}

Response

Created channel.

Example response

{
  "data": {
    "conversation_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "member_ids": [
      "01jzn7e61x3a7v9h2r7t2m3q4p"
    ]
  }
}