Agent Channels

Update channel

Update a channel's name, active status, or config. Human-only.

patch/v1/agents/{agent_id}/channels/{channel_id}

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/agents/{agent_id}/channels/{channel_id}
  • Auth: HTTP bearer

Path parameters

agent_idstring uuid required
channel_idstring uuid required

Request body

channel_namestring
is_activeboolean
configobject
slash_commands_enabledboolean
voice_transcription_enabledboolean
sender_allowliststring[]

External sender IDs permitted to trigger the agent and to run admin slash commands. An empty array clears it; omitting the field leaves it unchanged.

auto_respond_enabledboolean
owner_sender_idstring nullable

External sender ID treated as the channel owner for admin slash commands. Merged into channel metadata, which is where the slash-command authorizer reads it from. Set this or sender_allowlist to authorize admin commands. An explicit null revokes admin by removing the key; omitting the field leaves the current admin unchanged. Revoking is durable on a channel that has already received a message — the first-contact claim fires only when a channel has no prior inbound message.

Response

Channel updated

idstring uuid
org_idstring uuid
agent_idstring uuid
channel_type'telegram' | 'whatsapp' | 'discord'
channel_namestring
webhook_pathstring
webhook_urlstring
is_activeboolean
configobject nullable

Channel-specific configuration JSON. May include:

  • sender_allowlist (array of strings): restrict which external senders can trigger the agent
  • auto_respond_enabled (boolean): whether the agent auto-responds to inbound messages
slash_commands_enabledboolean

Whether Hermes-compatible slash commands are enabled for this channel. Commands: /help, /new, /reset, /clear, /model, /mode, /personality, /retry, /undo, /compress, /summarize, /stop, /status, /skills, /usage, /sethome.

voice_transcription_enabledboolean

Whether voice message transcription is enabled

unified_conversation_idstring uuid nullable

ID linking this channel to a unified cross-platform conversation

is_home_platformboolean

Whether this is the agent's home platform channel

sender_allowliststring[] nullable

List of allowed sender IDs for auto-respond

auto_respond_enabledboolean

Whether auto-respond is enabled for this channel

created_atstring date-time
updated_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.