Raise alert
signl4_raise_alertDestructive
WRITE: raise a new alert in a SIGNL4 team. THIS NOTIFIES REAL PEOPLE: every team member currently on duty is paged (push, SMS and/or voice call according to their settings) and the alert escalates if nobody acknowledges it. Only use it when the user clearly asked to alert the team; never for tests unless they said so. Not idempotent: a second call pages the team again. Returns the new alert incl. its id. POST /v3/signls.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Alert message body. | |
| title | Yes | Alert title, shown on the pager screen. | |
| team_id | Yes | SIGNL4 team id (a GUID); get it from signl4_list_teams. | |
| category | No | Category name, see signl4_list_categories (default: automatic). | |
| severity | No | Severity (default: SIGNL4's default for the team). | |
| external_id | No | Your own reference for this alert, for later look-up (and for SIGNL4 to group follow-ups). |