Skip to main content
PATCH
/
notifications
/
channels
/
{id}
curl -X PATCH "https://kodostatus.com/api/v1/notifications/channels/550e8400-e29b-41d4-a716-446655440000" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": false,
    "notify_on_maintenance": false
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Engineering Slack",
  "type": "slack",
  "enabled": false,
  "config": {
    "webhook_url": "https://hooks.slack.com/..."
  },
  "notify_on_incident": true,
  "notify_on_maintenance": false,
  "created_at": "2026-01-15T10:30:00.000Z",
  "updated_at": "2026-02-20T11:00:00.000Z"
}

​
Path Parameters

​
id
string
required
The unique identifier of the notification channel

​
Request Body

All fields are optional. Only include fields you want to update.
​
name
string
Display name for the channel
​
enabled
boolean
Enable or disable the channel
​
config
object
Channel-specific configuration (varies by type)
​
notify_on_incident
boolean
Whether to notify on incident events
​
notify_on_maintenance
boolean
Whether to notify on maintenance events

​
Response

Returns the updated notification channel object. 
curl -X PATCH "https://kodostatus.com/api/v1/notifications/channels/550e8400-e29b-41d4-a716-446655440000" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": false,
    "notify_on_maintenance": false
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Engineering Slack",
  "type": "slack",
  "enabled": false,
  "config": {
    "webhook_url": "https://hooks.slack.com/..."
  },
  "notify_on_incident": true,
  "notify_on_maintenance": false,
  "created_at": "2026-01-15T10:30:00.000Z",
  "updated_at": "2026-02-20T11:00:00.000Z"
}