Sign in

v1

latestOpenAPI 3.0.02026-07-26117198177.4 KB
Channels

Fetch a single alert channel

Returns the details of one alert channel that belongs to your workspace. Disabled channels are still returned (200); only deleted channels return 404.

get/v1/risk/channels/{channel_id}

Path parameters

channel_idstring required
Example:44444444-4444-4444-4444-444444444445

The alert channel id.

Response

idstring required
workspace_idstring required
namestring required
type'slack' | 'telegram' | 'discord' | 'webhook' | 'pagerduty' | 'email' | 'incidentio' required
enabledboolean required
connectedboolean required

Whether the channel is ready to receive deliveries. Always true except for a telegram channel that has not yet linked a chat.

created_atstring required
paramsobject

Type-specific channel parameters.

deleted_atstring nullable

Soft-delete timestamp. Null while the channel is active.

updated_atstring required

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "workspace_id": "workspace-123",
  "name": "My Slack Channel",
  "type": "slack",
  "enabled": true,
  "connected": true,
  "created_at": "2026-05-14T12:00:00.000Z",
  "params": {
    "webhook_url": "https://hooks.slack.com/services/T00/B00/xxxx"
  },
  "updated_at": "2026-05-14T12:00:00.000Z"
}