API Reference
The Alerta API lets trusted systems send alerts to connected delivery channels. New integrations should use the v2 API and credentials created in the Alerta dashboard.
Base URL
Use the production API base URL shown in your Alerta dashboard. The examples in this reference use:
https://api.usealerta.com
Authentication
Every public v2 request requires:
x-api-key: YOUR_API_KEY
x-api-secret: YOUR_API_SECRET
Content-Type: application/json
Create and manage these credentials in https://app.alerta.encrisoft.com.
Core Endpoints
| Method | Path | Use |
|---|---|---|
POST | /v2/slack/send | Send a Slack alert |
POST | /v2/slack/reply | Reply in a Slack thread |
POST | /v2/discord/send | Send a Discord alert |
POST | /v2/discord/reply | Reply to a Discord message |
POST | /v2/discord/start-thread | Start a Discord thread |
POST | /v2/discord/send-thread-message | Send to a Discord thread |
POST | /v2/teams/send | Send a Microsoft Teams alert |
POST | /v2/teams/reply | Reply to a Microsoft Teams message |