Skip to content

IChannels

v1 stable

/IChannels/v1/

Create, list, and delete channels within a space.

Authentication required

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

POST /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
spaceId
uuid
name
string
description
string | null
channelType
ChannelType
groupId
uuid | null

Response BotChannel

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

Errors

Status Code Description
400 missing_space_id spaceId is required.
400 validation_error The channel name, description, type or group is invalid.
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 '{"spaceId":"...","name":"...","description":null,"channelType":"...","groupId":null}' \
     https://gateway.argon.zone/IChannels/v1/Create
DELETE /IChannels/v1/Delete ManageChannels

Deletes a channel.

Query Parameters

Field Type
spaceId
uuid
channelId
uuid

Response DeletedResponse

Field Type
deleted boolean

Errors

Status Code Description
400 missing_space_id spaceId is required.
403 not_a_member Bot is not a member of this space.

Example

curl -X DELETE \
     -H "Authorization: Bot YOUR_TOKEN" \
     "https://gateway.argon.zone/IChannels/v1/Delete?spaceId=...&channelId=..."
GET /IChannels/v1/List

Lists all channels in a space.

Query Parameters

Field Type
spaceId
uuid

Response ChannelListResponse

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

Errors

Status Code Description
400 missing_space_id spaceId is required.
403 not_a_member Bot is not a member of this space.

Example

curl -X GET \
     -H "Authorization: Bot YOUR_TOKEN" \
     "https://gateway.argon.zone/IChannels/v1/List?spaceId=..."