---
title: "Test an alert"
description: "Sends a test message to each of the alert's channels now and returns each outcome. Webhooks receive the event `test`."
canonical: https://docs.rumoro.dev/api/alerts/test-alert
markdown: https://docs.rumoro.dev/api/alerts/test-alert.mdx
---

# Test an alert

`POST /v1/alerts/{id}/test`

Sends a test message to each of the alert's channels now and returns each outcome. Webhooks receive the event `test`.

## Parameters

| Name | In | Description |
| --- | --- | --- |
| `id` | path, required | The alert's id (feed_...). |

## Responses

| Status | Meaning |
| --- | --- |
| 200 | A test was tried on each of the alert's channels |
| 401 | The API key is missing or not valid |
| 404 | No alert with this id |

The [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) has every schema. Rules shared by all endpoints are in [Conventions](https://docs.rumoro.dev/conventions.mdx).