Uptimeify Docs
Notification channels

Update Notification Channel

Updates a notification channel.

PATCH /api/notification-channels/:id

Config is merged with existing secrets, preserving encrypted fields that are not provided.

Request Body (all optional)

FieldTypeDescription
typestringChannel type
namestringDisplay name
configobject|stringMerged with existing secrets
prioritynumberPriority order
delaySecondsnumberDelay before sending
conditionsobject|string|nullAlert conditions
allowedPackageTypesstring[]|nullPackage types this channel applies to
isActivebooleanWhether the channel is active

Example (cURL)

curl -X PATCH "$BASE_URL/api/notification-channels/1" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Email Channel",
    "isActive": true
  }'

Common errors

  • 401 Unauthorized when not authenticated
  • 403 Forbidden when accessing channels outside your scope
  • 404 Not found when the channel does not exist

Response

Returns the updated notification channel object. See Error Codes for error responses.

On this page