Uptimeify Docs
Notification channels

Delete Notification Channel

Deletes a notification channel. If the channel was an org-level default, organization defaults are automatically synced.

DELETE /api/notification-channels/:id

Example (cURL)

curl -X DELETE "$BASE_URL/api/notification-channels/1" \
  -H "Authorization: Bearer $TOKEN"

Response

{ "success": 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

Permissions

Organization admins may write channels at any level. A customer-scoped login (role readonly) may create, update and delete channels bound to one of ITS OWN customers: that is what the integrations page in the dashboard offers the role, and until 04.09.2026 the API refused it with a bare 403.

Two limits remain. An ORGANIZATION-level channel, one carrying no customerId, stays admin-only. And a channel of a customer outside the caller's scope is refused, as before. The roles editor and responder are not writers here.

Create Notification Channel

Creates a new notification channel. Secrets in config are encrypted server-side.

List Notification Channels

Returns notification channels scoped by organization, customer, or website.

On this page

Example (cURL)ResponseCommon errorsPermissions