# uip maestro flow incident

> Syntax and options for `uip maestro flow incident`, which reads tenant-wide or single-record incidents raised during Flow process execution.

`uip maestro 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 maestro flow incident summary
uip maestro flow incident get <incident-id> --folder-key <key>
```

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

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

## uip maestro 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 maestro 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 maestro flow incident summary

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

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

## See also

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