---
title: "List alert channels for the caller workspace"
method: GET
path: "/v1/risk/channels"
tags: ["Channels"]
---

# List alert channels for the caller workspace

`GET /v1/risk/channels`

Returns every non-deleted alert channel for your workspace, including disabled ones. Each item carries `enabled` (your on/off state) and `connected` (delivery readiness). To hide a channel, delete it — disabling only stops delivery.

## Response `200`

- ListAlertChannelsResponseDto
  - `items` AlertChannelListItemDto[], required
    - `id` string, required
    - `workspace_id` string, required
    - `name` string, required
    - `type` 'slack' | 'telegram' | 'discord' | 'webhook' | 'pagerduty' | 'email' | 'incidentio', required
    - `enabled` boolean, required
    - `connected` boolean, required — Whether the channel is ready to receive deliveries. Always true except for a telegram channel that has not yet linked a chat.
    - `created_at` string, required
    - `params` object — Type-specific params surfaced in list items. Present only for telegram channels, carrying the registration `unique_code`.

---

[API](https://skmtc.net/range/apis/range-platform-api.md) · [All operations](https://skmtc.net/range/apis/range-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/range/range-platform-api/revisions/9926df2e476d/schema)