Skip to main content
GET
/
v1
/
risk
/
channels
/
{channel_id}
Fetch a single alert channel
curl --request GET \
  --url https://api.range.org/v1/risk/channels/{channel_id} \
  --header 'Authorization: Bearer <token>'
{
  "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",
  "updated_at": "2026-05-14T12:00:00.000Z",
  "params": {
    "webhook_url": "https://hooks.slack.com/services/T00/B00/xxxx"
  },
  "deleted_at": null
}

Authorizations

Authorization
string
header
required

Use Authorization: Bearer

Path Parameters

channel_id
string
required

The alert channel id.

Example:

"44444444-4444-4444-4444-444444444445"

Response

200 - application/json
id
string
required
Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

workspace_id
string
required
Example:

"workspace-123"

name
string
required
Example:

"My Slack Channel"

type
enum<string>
required
Available options:
slack,
telegram,
discord,
webhook,
pagerduty,
email,
incidentio
Example:

"slack"

enabled
boolean
required
Example:

true

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.

Example:

true

created_at
string
required
Example:

"2026-05-14T12:00:00.000Z"

updated_at
string
required
Example:

"2026-05-14T12:00:00.000Z"

params
object

Type-specific channel parameters.

Example:
{
"webhook_url": "https://hooks.slack.com/services/T00/B00/xxxx"
}
deleted_at
string | null

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

Example:

null

Last modified on July 1, 2026