Skip to main content
POST
Create Alert

Authorizations

Authorization
string
header
required

Bearer token using your Warrn API key.

Body

application/json
name
string
required

Short summary of the alert.

Maximum string length: 255
description
string
required

Detailed description of the issue.

severity
enum<string>
required
Available options:
low,
medium,
high,
critical
team_id
string<uuid>
required

Team this alert is routed to. Required.

service_id
string<uuid>

Service this alert belongs to. Optional.

tags
string[]
metadata
object

Arbitrary key-value pairs (runbook URLs, affected hosts, metric values).

alert_alias
string | null

Dedup key. While an alert with this alias is open or acknowledged, repeat creates with the same alias increment its occurrence_count instead of creating a new alert. Once resolved, the next create with the same alias makes a new alert. Also accepted as the path identifier on /alerts/{identifier}/resolve/?identifierType=alias.

Response

Alert created

id
string<uuid>
name
string
description
string
severity
enum<string>
Available options:
low,
medium,
high,
critical
status
enum<string>
Available options:
open,
acknowledged,
resolved
source
string
Example:

"integration"

service_id
string<uuid> | null
service_name
string | null
team_id
string<uuid> | null
team_name
string | null
tags
string[]
metadata
object
created_at
string<date-time>
updated_at
string<date-time>
acknowledged_at
string<date-time> | null
resolved_at
string<date-time> | null
alert_alias
string | null
occurrence_count
integer