---
title: "Test Alert Channel"
method: POST
path: "/api/v1/alerts/channels/{channel_id}/test"
tags: ["alerts"]
---

# Test Alert Channel

`POST /api/v1/alerts/channels/{channel_id}/test`

## Request

- Base URL: `https://monit.rs`
- URL: `https://monit.rs/api/v1/alerts/channels/{channel_id}/test`
- Auth: HTTP bearer

Requires write:alerts. Sends a test to an active channel owned by the account. Success means provider acceptance, not confirmed inbox receipt. Successful tests update /alerts/readiness; they do not create incident history.

## Path parameters

- `channel_id` string, uuid, required

## Response `200`

Successful Response

- AlertChannelTestResponse
  - `status` string, required
  - `message` string, required

## Other responses

- `401`: Missing or invalid bearer credentials.
- `403`: Missing required alert scope.
- `404`: Channel not found for this account.
- `409`: Channel is inactive.
- `422`: Validation Error
- `429`: Rate limit exceeded.
- `502`: Provider did not accept the test alert.

---

[API](https://skmtc.dev/monit/apis/monit-rs-public-api.md) · [All operations](https://skmtc.dev/monit/apis/monit-rs-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/monit/apis/monit-rs-public-api/revisions/7e1923981112?raw)