---
title: "Update channel"
method: PATCH
path: "/v1/agents/{agent_id}/channels/{channel_id}"
tags: ["Agent Channels"]
---

# Update channel

`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

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

## Path parameters

- `agent_id` string, uuid, required
- `channel_id` string, uuid, required

## Request body

- UpdateChannelRequest
  - `channel_name` string
  - `is_active` boolean
  - `config` object
  - `slash_commands_enabled` boolean
  - `voice_transcription_enabled` boolean
  - `sender_allowlist` string[]: 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_enabled` boolean
  - `owner_sender_id` string, 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 `200`

Channel updated

- ChannelResponse
  - `id` string, uuid
  - `org_id` string, uuid
  - `agent_id` string, uuid
  - `channel_type` 'telegram' | 'whatsapp' | 'discord'
  - `channel_name` string
  - `webhook_path` string
  - `webhook_url` string
  - `is_active` boolean
  - `config` object, 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_enabled` boolean: 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_enabled` boolean: Whether voice message transcription is enabled
  - `unified_conversation_id` string, uuid, nullable: ID linking this channel to a unified cross-platform conversation
  - `is_home_platform` boolean: Whether this is the agent's home platform channel
  - `sender_allowlist` string[], nullable: List of allowed sender IDs for auto-respond
  - `auto_respond_enabled` boolean: Whether auto-respond is enabled for this channel
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401`: Authentication required or invalid
- `403`: Insufficient permissions
- `404`: Resource not found

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/5fa0918f3b41?raw)