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

# Incident statuses

> The seven possible statuses, who changes them, and the valid transitions.

## Statuses

| Status         | Meaning                                      | Origin                    |
| -------------- | -------------------------------------------- | ------------------------- |
| `triggered`    | Incident created from a processed alert.     | System                    |
| `notified`     | At least one notification channel delivered. | System                    |
| `acknowledged` | Someone acknowledged the incident.           | Person                    |
| `assigned`     | The incident has a defined owner.            | Person or system          |
| `escalated`    | Escalated by timeout or manually.            | System or person          |
| `resolved`     | Problem over.                                | Person or auto-resolution |
| `closed`       | Incident closed out.                         | Person                    |

## Transitions

```mermaid theme={null}
stateDiagram-v2
  [*] --> triggered
  triggered --> notified
  notified --> acknowledged
  notified --> assigned
  notified --> escalated
  escalated --> acknowledged
  escalated --> assigned
  acknowledged --> assigned
  acknowledged --> resolved
  assigned --> resolved
  escalated --> resolved
  resolved --> closed
  closed --> [*]
```

<Note>
  `resolved` and `closed` incidents **do not go back** to open states. A new trigger of the same alert creates a new incident.
</Note>

## Side effects

| Transition       | Additional effect                                      |
| ---------------- | ------------------------------------------------------ |
| → `acknowledged` | Stops automatic escalation.                            |
| → `assigned`     | Notifies the new owner.                                |
| → `escalated`    | Reassigns to the next target and restarts the timeout. |
| → `resolved`     | Notifies the configured channels and stops the clock.  |

## Timeline events

Statuses say **what the incident is now**; events say **what happened**:

`alert received` · `incident created` · `alert aggregated` · `notified` · `acknowledged` · `assigned` · `reassigned` · `escalated` · `escalation timeout` · `escalation exhausted` · `fallback incident` · `resolved` · `closed`

<Card title="Detailed lifecycle" icon="siren" horizontal href="/en/incidents/lifecycle" />
