# Notification Channels

Configure notification delivery through webhooks or Telegram.

 - [GET /channels](https://docs.vilna.io/apis/platform/api/channel/list-channels.md): List channels with filtering and pagination.
 - [POST /channels](https://docs.vilna.io/apis/platform/api/channel/create-channel.md): Create a channel. The configuration schema is selected by `config.kind`. Retry the same request with the same `Idempotency-Key` to replay its original completed response under current authorization: o
 - [GET /channels/{channel_id}](https://docs.vilna.io/apis/platform/api/channel/get-channel.md): Get channel details by ID.
 - [DELETE /channels/{channel_id}](https://docs.vilna.io/apis/platform/api/channel/delete-channel.md): Delete a channel by ID.
 - [PATCH /channels/{channel_id}](https://docs.vilna.io/apis/platform/api/channel/patch-channel.md): Update channel metadata or configuration. Name, configuration, availability and the attempt budget are validated and applied together, and `kind` cannot change.
 - [POST /channels/{channel_id}/actions/test](https://docs.vilna.io/apis/platform/api/channel/test-channel.md): Send a synthetic message of the given family through the channel, rendered in the channel's own format. A disabled channel may be tested; the test does not change channel state. One attempt is made an
 - [GET /channels/{channel_id}/webhook-secrets](https://docs.vilna.io/apis/platform/api/channel/get-channel-webhook-secrets.md): Returns the channel's signing secrets: always a `current` secret, plus a `previous` secret during the 24-hour rotation overlap window. Only valid for channels with `kind=webhook`; otherwise returns 40
 - [POST /channels/{channel_id}/webhook-secrets/actions/rotate](https://docs.vilna.io/apis/platform/api/channel/rotate-channel-webhook-secret.md): Issues a new signing secret, demotes the existing current to previous for a 24-hour overlap window, and returns the new plaintext value. The plaintext is returned only here; store it immediately. Duri
 - [DELETE /channels/{channel_id}/webhook-secrets/previous](https://docs.vilna.io/apis/platform/api/channel/delete-channel-previous-webhook-secret.md): Ends the rotation overlap window early. After this call, outgoing webhooks are signed only with the current secret. Idempotent: if there is no previous secret (the channel has never been rotated, or i