> ## Documentation Index
> Fetch the complete documentation index at: https://docs.healops.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# incident.io

> Connect incident.io so HealOps can read incident context, updates, and metadata during investigations

HealOps can use incident.io as incident context during RCA. The integration can list live incidents, fetch full incident metadata, read incident updates, and append final findings to the incident summary through the supported incident edit API.

## Prerequisites

* incident.io account
* incident.io API key with read access to incidents and incident updates
* Write permission if you want HealOps to append findings to incident summaries

## Setup

### Interactive CLI

```bash theme={null}
healops integrations setup incident_io
```

### Environment variables

```bash theme={null}
INCIDENT_IO_API_KEY=your-api-key
```

| Variable               | Default                   | Description                                            |
| ---------------------- | ------------------------- | ------------------------------------------------------ |
| `INCIDENT_IO_API_KEY`  | -                         | Required incident.io API key                           |
| `INCIDENT_IO_BASE_URL` | `https://api.incident.io` | Optional API URL override for tests or private routing |

## Verify

```bash theme={null}
healops integrations verify incident_io
```

Verification performs a minimal `GET /v2/incidents` request.

## Investigation Behavior

When an alert includes an incident.io incident ID or URL, HealOps makes the `incident_io_incidents` action available with `action="context"`. That reads:

* incident metadata from `GET /v2/incidents/{id}`
* incident updates from `GET /v2/incident_updates?incident_id={id}`

If no incident ID is present, HealOps can use `action="list"` to list live incidents.

## Write-Back

HealOps does not create native timeline events. incident.io's public v2 API supports editing incidents, so HealOps write-back uses:

```text theme={null}
POST /v2/incidents/{id}/actions/edit
```

The action appends findings to the incident summary. Use `action="append_summary"` only after the RCA has useful findings or next steps ready to publish.