Conversations

Create a channel

Changed on

Creates a channel in the authenticated workspace. Same operation as the MCP create_channel 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

  • Base URL
    https://api.ando.so/v1
  • URL
    https://api.ando.so/v1/conversations
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

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"
    ]
  }
}

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      endpoint added