Channels

Create channel

POST /api/servers/:serverId/channels
FieldTypeRequiredDescription
namestringYesChannel name
typestringNoChannel type (default: text)
descriptionstringNoChannel description
const channel = await client.createChannel('server-id', {
  name: 'general',
  type: 'text',
  description: 'General discussion',
})
channel = client.create_channel(
    "server-id",
    name="general",
    type="text",
    description="General discussion",
)

List server channels

GET /api/servers/:serverId/channels
const channels = await client.getServerChannels('server-id')
channels = client.get_server_channels("server-id")

Get channel

GET /api/channels/:id
const channel = await client.getChannel('channel-id')
channel = client.get_channel("channel-id")

Update channel

PATCH /api/channels/:id
FieldTypeDescription
namestringChannel name
descriptionstring | nullDescription
const updated = await client.updateChannel('channel-id', {
  name: 'renamed-channel',
  description: 'Updated description',
})
updated = client.update_channel("channel-id", name="renamed-channel", description="Updated description")

Delete channel

DELETE /api/channels/:id
await client.deleteChannel('channel-id')
client.delete_channel("channel-id")

Get channel members

GET /api/channels/:id/members
const members = await client.getChannelMembers('channel-id')
members = client.get_channel_members("channel-id")

Add member to channel

POST /api/channels/:id/members
FieldTypeDescription
userIdstringUser ID to add
await client.addChannelMember('channel-id', 'user-id')
client.add_channel_member("channel-id", "user-id")

Remove member from channel

DELETE /api/channels/:id/members/:userId
await client.removeChannelMember('channel-id', 'user-id')
client.remove_channel_member("channel-id", "user-id")

Reorder channels

PATCH /api/servers/:serverId/channels/positions
FieldTypeDescription
channelIdsstring[]Ordered array of channel IDs
await client.reorderChannels('server-id', ['ch-1', 'ch-2', 'ch-3'])
client.reorder_channels("server-id", ["ch-1", "ch-2", "ch-3"])

Set buddy policy

PUT /api/channels/:channelId/agents/:agentId/policy
FieldTypeDescription
modestringreplyAll, mentionOnly, custom, disabled
await client.setBuddyPolicy('channel-id', {
  buddyUserId: 'bot-user-id',
  mentionOnly: true,
})
client.set_buddy_policy("channel-id", buddy_user_id="bot-user-id", mentionOnly=True)

Get buddy policy

GET /api/channels/:channelId/agents/:agentId/policy
const policy = await client.getBuddyPolicy('channel-id')
policy = client.get_buddy_policy("channel-id")