Incident Endpoints

Create, manage, and execute incidents programmatically.

Create Incident

POST /incidents

Create a new incident

curl -X POST https://api.commhero.io/v1/incidents   -H "Authorization: Bearer YOUR_TOKEN"   -H "Content-Type: application/json"   -d '{
    "title": "API Service Outage",
    "severity": "critical",
    "description": "Database connection pool exhausted",
    "impact": "Users unable to log in",
    "template_ids": ["tpl_123", "tpl_456"]
  }'

List Incidents

GET /incidents

Get all incidents (paginated)

curl https://api.commhero.io/v1/incidents   -H "Authorization: Bearer YOUR_TOKEN"

Get Incident

GET /incidents/{id}

Get details about a specific incident

curl https://api.commhero.io/v1/incidents/inc_123   -H "Authorization: Bearer YOUR_TOKEN"

Execute Incident

POST /incidents/{id}/execute

Send incident messages to all channels

curl -X POST https://api.commhero.io/v1/incidents/inc_123/execute   -H "Authorization: Bearer YOUR_TOKEN"   -H "Content-Type: application/json"   -d '{
    "variables": {
      "eta": "3:30 PM UTC",
      "affected_systems": "Auth API",
      "status": "Investigating"
    }
  }'

Update Incident

PATCH /incidents/{id}

Update incident status or details

curl -X PATCH https://api.commhero.io/v1/incidents/inc_123   -H "Authorization: Bearer YOUR_TOKEN"   -H "Content-Type: application/json"   -d '{
    "status": "resolved",
    "resolution_summary": "Cache cleared, issue resolved"
  }'

Close Incident

POST /incidents/{id}/close

Mark an incident as closed