IChannels

v1 stable

/api/bot/IChannels/v1/

Create, list, and delete channels within a space.

072a7e2baab2176a… SHA-256 contract hash — guaranteed stable

Authentication required

All endpoints require Authorization: Bot <token> header. Get a token →

POST /api/bot/IChannels/v1/Create ManageChannels

Creates a new channel in a space. Specify name, type (text or voice), and optionally a channel group.

Request Body CreateChannelRequest

Field Type
channelType "text" | "voice" | "announcement"
description string
groupId string | null
name string
spaceId string

Response BotChannel

Field Type
channelId string
channelType string
description string
groupId string | null
name string
spaceId string

Errors

Status Code Description
403 not_a_member Bot is not a member of this space.

Example

$ curl -X POST \
     -H "Authorization: Bot YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"channelType":"...","description":"...","groupId":null,"name":"...","spaceId":"..."}' \
     https://api.argon.gl/api/bot/IChannels/v1/Create
DELETE /api/bot/IChannels/v1/Delete ManageChannels

Deletes a channel. Pass spaceId and channelId as query parameters.

Response DeletedResponse

Field Type
deleted boolean

Errors

Status Code Description
403 not_a_member Bot is not a member of this space.

Example

$ curl -X DELETE \
     -H "Authorization: Bot YOUR_TOKEN" \
     https://api.argon.gl/api/bot/IChannels/v1/Delete
GET /api/bot/IChannels/v1/List

Lists all channels in a space. Pass spaceId as a query parameter.

Response ChannelListResponse

Field Type
channels BotChannel[]
↳ channelId string
↳ channelType string
↳ description string
↳ groupId string | null
↳ name string
↳ spaceId string

Errors

Status Code Description
403 not_a_member Bot is not a member of this space.

Example

$ curl -X GET \
     -H "Authorization: Bot YOUR_TOKEN" \
     https://api.argon.gl/api/bot/IChannels/v1/List