# uip flow incidents

> `uip flow incident` reads incidents — unhandled errors raised during Flow process execution — either as tenant-wide summaries or as a single record by ID. The command name is singular (`incident`) even though the file and sidebar entry say `incidents`.

`uip flow incident` reads incidents — unhandled errors raised during Flow process execution — either as tenant-wide summaries or as a single record by ID. The command name is singular (`incident`) even though the file and sidebar entry say `incidents`.

All subcommands require `uip login` and honor [global options](./global-options.md). Exit codes follow the [standard contract](./exit-codes.md).

## Synopsis

```
uip flow incident summary
uip flow incident get <incident-id> --folder-key <key>
```

For incidents scoped to a specific process or instance, use:

- [`uip flow processes incidents <process-key>`](./uip-flow-process.md#uip-flow-processes-incidents) — all incidents for one process.
- [`uip flow instance incidents <instance-id>`](./uip-flow-instances.md#uip-flow-instance-incidents) — all incidents for one running instance.

## uip flow incident summary

Get a tenant-wide rollup of incidents across Flow processes.

### Arguments

None.

### Options

None beyond globals.

### Data shape (`--output json`)

```json
{
  "Code": "IncidentSummary",
  "Data": [ /* array of incident summaries */ ]
}
```

The list is returned unfiltered — use `--output-filter` with a JMESPath query to extract specific fields.

## uip flow incident get

Get a single incident by ID.

### Arguments

- `<incident-id>` *(required)* — incident ID. URL-encoded automatically.

### Options

- `--folder-key <key>` *(required)* — folder key.

### Data shape

```json
{
  "Code": "IncidentGet",
  "Data": { /* incident details */ }
}
```

## Examples

```bash
# Tenant-wide incident rollup
uip flow incident summary

# Extract just the incident IDs and counts
uip flow incident summary --output-filter "[*].{processKey:processKey,count:incidentCount}"

# Get a specific incident
uip flow incident get "inc_abcdef1234" --folder-key <folder-key>
```

## See also

- [`uip flow instance incidents`](./uip-flow-instances.md#uip-flow-instance-incidents) — incidents for one instance
- [`uip flow processes incidents`](./uip-flow-process.md#uip-flow-processes-incidents) — incidents for one process definition
- [`uip flow instance retry`](./uip-flow-instances.md#uip-flow-instance-retry) — remediate a faulted instance
- [Flow overview](./uip-flow.md)