---
title: "Edit a notification channel"
method: PATCH
path: "/notifications/{id}"
tags: ["notifications"]
---

# Edit a notification channel

`PATCH /notifications/{id}`

## Path parameters

- `id` string, required

## Request body

- union
  - EmailNotification
    - `notificationName` string, required
    - `type` 'email', required
    - `address` string, email, required
    - `homeserverUrl` union
      - string
      - ''
    - `roomId` union
      - string
      - ''
    - `accessToken` union
      - string
      - ''
  - WebhookNotification
    - `notificationName` string, required
    - `type` 'webhook', required
    - `address` string, uri, required
    - `homeserverUrl` union
      - string
      - ''
    - `roomId` union
      - string
      - ''
    - `accessToken` union
      - string
      - ''
  - SlackNotification
    - `notificationName` string, required
    - `type` 'slack', required
    - `address` string, uri, required
    - `homeserverUrl` union
      - string
      - ''
    - `roomId` union
      - string
      - ''
    - `accessToken` union
      - string
      - ''
  - DiscordNotification
    - `notificationName` string, required
    - `type` 'discord', required
    - `address` string, uri, required
    - `homeserverUrl` union
      - string
      - ''
    - `roomId` union
      - string
      - ''
    - `accessToken` union
      - string
      - ''
  - PagerDutyNotification
    - `notificationName` string, required
    - `type` 'pager_duty', required
    - `address` string, required
    - `homeserverUrl` union
      - string
      - ''
    - `roomId` union
      - string
      - ''
    - `accessToken` union
      - string
      - ''
  - MatrixNotification
    - `notificationName` string, required
    - `type` 'matrix', required
    - `address` union
      - string
      - ''
    - `homeserverUrl` string, uri, required
    - `roomId` string, required
    - `accessToken` string, required
  - TeamsNotification
    - `notificationName` string, required
    - `type` 'teams', required
    - `address` string, uri, required
  - TelegramNotification
    - `notificationName` string, required
    - `type` 'telegram', required
    - `address` string, required
    - `accessToken` string, required
  - PushoverNotification
    - `notificationName` string, required
    - `type` 'pushover', required
    - `address` string, required
    - `accessToken` string, required
  - TwilioNotification
    - `notificationName` string, required
    - `type` 'twilio', required
    - `accountSid` string, required
    - `accessToken` string, required
    - `phone` string, required
    - `twilioPhoneNumber` string, required
  - NtfyNotification
    - `notificationName` string, required
    - `type` 'ntfy', required
    - `address` string, uri, required
    - `topic` string, required

## Response `200`

OK

- object
  - `success` true, required
  - `msg` string, required
  - `data` unknown

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal server error

## Changes

- **2026-05-27** `dd1708803c7c` — 2 info
  - added `ntfy` mapping keys to the request discriminator
  - added `#/components/schemas/NtfyNotification` to the request body `oneOf` list
- **2026-05-01** `39082d385dda` — 1 info
  - endpoint added
- **2025-04-20** `b97ec6888b3c` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/bluewave-labs/apis/checkmate-api/changes/notifications/:id/patch.md)

---

[API](https://skmtc.dev/bluewave-labs/apis/checkmate-api.md) · [All operations](https://skmtc.dev/bluewave-labs/apis/checkmate-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bluewave-labs/checkmate-api/revisions/0ecdfd20a742/schema)