Update a notification-channel
PUT /notification-channels/{id}
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”DocumentId
Request Body required
Section titled “Request Body required ”object
object
DEPRECATED plaintext field — retained read-only for pre-encryption legacy rows. New writes always go to encrypted_webhook_url. NEVER returned by the API.
AES-256-GCM encrypted webhook_url (F3.CHATOPS.01) — same iv:authTag:ciphertext:salt format as BYOC cloud-credential (src/utils/credential-crypto.ts). NEVER returned by the API; decrypted only server-side by webhook-notifier for dispatch.
Array of subscribed event-type strings. Canonical catalog (F3.CHATOPS.01): ‘billing.payment_failed’, ‘billing.trial_ending’, ‘cloud-instance.provision_failed’, ‘alert.fired’. Empty/null = all events.
Responses
Section titled “ Responses ”Updated
object
object
DEPRECATED plaintext field — retained read-only for pre-encryption legacy rows. New writes always go to encrypted_webhook_url. NEVER returned by the API.
AES-256-GCM encrypted webhook_url (F3.CHATOPS.01) — same iv:authTag:ciphertext:salt format as BYOC cloud-credential (src/utils/credential-crypto.ts). NEVER returned by the API; decrypted only server-side by webhook-notifier for dispatch.
Array of subscribed event-type strings. Canonical catalog (F3.CHATOPS.01): ‘billing.payment_failed’, ‘billing.trial_ending’, ‘cloud-instance.provision_failed’, ‘alert.fired’. Empty/null = all events.
Validation error
Missing or invalid authentication
Not authorized (tenant scope or capability)
Not found