---
title: "List channels"
method: GET
path: "/v1/agents/{agent_id}/channels"
tags: ["Agent Channels"]
---

# List channels

`GET /v1/agents/{agent_id}/channels`

## Request

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

List all messaging channels for an agent.

## Path parameters

- `agent_id` string, uuid, required

## Response `200`

Channel list

- ChannelListResponse
  - `channels` 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

---

[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)