Skip to main content
POST
/
v2
/
alerts
/
{identifier}
/
close
curl -X POST "https://api.warrn.io/v2/alerts/cpu-high-web-03/close?identifierType=alias" \
  -H "Authorization: Bearer warrn_k8sM2vL9xQ7nP4wR..."

{
  "result": "Request will be processed",
  "took": 0.0,
  "requestId": "f7a8b9c0-d1e2-3456-7890-abcdef123456"
}

Documentation Index

Fetch the complete documentation index at: https://docs.warrn.io/llms.txt

Use this file to discover all available pages before exploring further.

Close an alert, setting its status to resolved. Use identifierType=alias to close by the alias you set when creating the alert.

​
Authentication

​
Authorization
string
required
Bearer token. Format: Bearer warrn_xxx. Requires write permission.

​
Path Parameters

​
identifier
string
required
The alert identifier. Can be a Warrn UUID, an alias, or a tiny ID depending on the identifierType parameter.

​
Query Parameters

​
identifierType
string
default:"id"
How to interpret the identifier. One of: id, alias, tiny.

​
Request Body

The request body is optional. No fields are required.

​
Response

​
result
string
Always "Request will be processed".
​
requestId
string
Unique request ID for tracing.

​
Examples

​
Close by alias

The most common pattern — use the same alias you set when creating the alert: 
curl -X POST "https://api.warrn.io/v2/alerts/cpu-high-web-03/close?identifierType=alias" \
  -H "Authorization: Bearer warrn_k8sM2vL9xQ7nP4wR..."

{
  "result": "Request will be processed",
  "took": 0.0,
  "requestId": "f7a8b9c0-d1e2-3456-7890-abcdef123456"
}

​
Close by ID

curl -X POST "https://api.warrn.io/v2/alerts/a1b2c3d4-e5f6-7890-abcd-ef1234567890/close" \
  -H "Authorization: Bearer warrn_k8sM2vL9xQ7nP4wR..."

​
Typical Workflow

Create an alert with a stable alias, then close it when the issue resolves: 
# 1. Alert fires — create with alias
curl -X POST "https://api.warrn.io/v2/alerts" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer warrn_k8sM2vL9xQ7nP4wR..." \
  -d '{"message": "Disk full on db-01", "alias": "disk-full-db-01", "priority": "P2"}'

# 2. Issue resolved — close by alias
curl -X POST "https://api.warrn.io/v2/alerts/disk-full-db-01/close?identifierType=alias" \
  -H "Authorization: Bearer warrn_k8sM2vL9xQ7nP4wR..."
If no alert is found with the given alias, the endpoint returns an error response with the message "Alert not found with alias: {your-alias}".