Skip to main content
POST
/
alerts
curl -X POST "https://api.warrn.io/alerts/" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer warrn_k8sM2vL9xQ7nP4wR..." \
  -d '{
    "name": "High error rate on checkout-service",
    "description": "Error rate exceeded 5% threshold for the past 3 minutes. Affected endpoint: POST /api/checkout",
    "severity": "high",
    "service_id": "d4e5f6a7-b8c9-0123-4567-89abcdef0123",
    "tags": ["checkout", "production", "error-rate"],
    "metadata": {
      "error_rate": "7.2%",
      "threshold": "5%",
      "runbook": "https://wiki.internal/runbooks/checkout-errors"
    }
  }'

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "High error rate on checkout-service",
  "description": "Error rate exceeded 5% threshold for the past 3 minutes. Affected endpoint: POST /api/checkout",
  "severity": "high",
  "status": "open",
  "source": "integration",
  "service_id": "d4e5f6a7-b8c9-0123-4567-89abcdef0123",
  "service_name": "checkout-service",
  "team_id": null,
  "team_name": null,
  "tags": ["checkout", "production", "error-rate"],
  "metadata": {
    "error_rate": "7.2%",
    "threshold": "5%",
    "runbook": "https://wiki.internal/runbooks/checkout-errors"
  },
  "created_at": "2026-05-05T14:30:00.000000+05:30",
  "updated_at": "2026-05-05T14:30:00.000000+05:30",
  "acknowledged_at": null,
  "resolved_at": null,
  "alert_alias": null,
  "occurrence_count": 1
}

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.

Create an alert and route it through Warrn’s triage pipeline.

​
Authentication

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

​
Request Body

​
name
string
required
Short summary of the alert. Max 255 characters.
​
description
string
required
Detailed description of the issue.
​
severity
string
required
Alert severity. One of: low, medium, high, critical.
​
service_id
uuid
ID of the service this alert belongs to.
​
team_id
uuid
ID of the team responsible for this alert.
​
tags
string[]
default:"[]"
List of tags for categorization and filtering.
​
metadata
object
default:"{}"
Arbitrary key-value pairs. Use this to attach context from your monitoring tool (runbook URLs, affected hosts, metric values).

​
Response

Returns the created alert object.
​
id
uuid
Unique alert identifier. Use this for subsequent operations (acknowledge, resolve).
​
name
string
Alert name.
​
status
string
Initial status. Always open for new alerts.
​
severity
string
Alert severity level.
​
source
string
Set to integration for API-created alerts.
​
created_at
datetime
ISO 8601 timestamp.
​
alert_alias
string | null
Deduplication alias, if set.

​
Example

curl -X POST "https://api.warrn.io/alerts/" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer warrn_k8sM2vL9xQ7nP4wR..." \
  -d '{
    "name": "High error rate on checkout-service",
    "description": "Error rate exceeded 5% threshold for the past 3 minutes. Affected endpoint: POST /api/checkout",
    "severity": "high",
    "service_id": "d4e5f6a7-b8c9-0123-4567-89abcdef0123",
    "tags": ["checkout", "production", "error-rate"],
    "metadata": {
      "error_rate": "7.2%",
      "threshold": "5%",
      "runbook": "https://wiki.internal/runbooks/checkout-errors"
    }
  }'

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "High error rate on checkout-service",
  "description": "Error rate exceeded 5% threshold for the past 3 minutes. Affected endpoint: POST /api/checkout",
  "severity": "high",
  "status": "open",
  "source": "integration",
  "service_id": "d4e5f6a7-b8c9-0123-4567-89abcdef0123",
  "service_name": "checkout-service",
  "team_id": null,
  "team_name": null,
  "tags": ["checkout", "production", "error-rate"],
  "metadata": {
    "error_rate": "7.2%",
    "threshold": "5%",
    "runbook": "https://wiki.internal/runbooks/checkout-errors"
  },
  "created_at": "2026-05-05T14:30:00.000000+05:30",
  "updated_at": "2026-05-05T14:30:00.000000+05:30",
  "acknowledged_at": null,
  "resolved_at": null,
  "alert_alias": null,
  "occurrence_count": 1
}