Create and manage FireHydrant incidents and trigger runbooks via the FireHydrant API

Steps

1. Obtain a FireHydrant API token from Settings > API Keys; authenticate all requests with Authorization: Bearer YOUR_TOKEN and Content-Type: application/json
2. List available severities and environments: GET /v1/severities and GET /v1/environments to retrieve IDs required for incident creation
3. Declare an incident: POST /v1/incidents with name, severity.id, and optionally impacted_services (array of service IDs from GET /v1/services) and environments
4. Attach and trigger a runbook: POST /v1/incidents/{id}/runbook_actions to manually trigger a runbook step, or configure the runbook in FireHydrant UI to auto-attach based on conditions like severity or impacted service
5. Add a timeline event or status update: POST /v1/incidents/{id}/events with type and body to document decisions or communications during the incident
6. Resolve the incident: PATCH /v1/incidents/{id} with state: resolved and a resolution summary; this triggers any configured resolution runbook steps