Skip to main content
GET
/
api
/
v1
/
alert-channels
List active alert channels for the authenticated org
curl --request GET \
  --url https://api.devhelm.io/api/v1/alert-channels \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "displayConfig": {
        "recipients": [
          "<string>"
        ],
        "region": "<string>",
        "severityOverride": "<string>",
        "mentionRoleId": "<string>",
        "customHeaders": {}
      },
      "configHash": "<string>",
      "lastDeliveryAt": "2023-11-07T05:31:56Z",
      "lastDeliveryStatus": "<string>"
    }
  ],
  "hasNext": true,
  "hasPrev": true,
  "totalElements": 123,
  "totalPages": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.devhelm.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key (dh_live_...) or Auth0 JWT token

Query Parameters

​
type
enum<string>

Filter by channel integration type (e.g. SLACK, WEBHOOK, EMAIL)

Available options:
email,
webhook,
slack,
pagerduty,
opsgenie,
teams,
discord
​
managedBy
enum<string>

Filter by managed-by source (DASHBOARD, CLI, TERRAFORM, MCP, API)

Available options:
DASHBOARD,
CLI,
TERRAFORM,
MCP,
API
​
search
string

Case-insensitive contains-match on the channel name

​
pageable
object
required

Response

OK

​
data
object[]
required
​
hasNext
boolean
required
​
hasPrev
boolean
required
​
totalElements
integer<int64> | null
​
totalPages
integer<int32> | null