Update notification channel
PUT /api/v1/notification-channels/{id}
PUT
/api/v1/notification-channels/{id}
Updates an existing notification channel. Requires write scope.
At least one of name or config must be provided.
Channel type cannot be changed.
For email channels, changing the to address resets verification and sends a new verification email.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” id
required
string
Request Body required
Section titled “Request Body required ”object
name
string
config
Partial or full replacement of the channel config. Validated against the existing channel type.
object
Responses
Section titled “ Responses ”Updated channel
object
channel
Notification channel (config field excluded — contains secrets)
object
id
ULID
string
teamId
string
type
string
name
string
isActive
integer
verified
Email channels start unverified (0) until the user clicks the verification link. All other types are always 1.
integer
createdAt
string format: date-time
Invalid config or missing fields
Unauthorized
Write scope required
Channel not found