# flow2act · Audit-Verlauf

Lies geordnete Audit-Ereignisse einer Ausführung.

Nur aktive angemeldete Mitglieder einer zugeordneten Freigabe- oder Kenntnisnahmegruppe mit offenem oder abgeschlossenem Schritt dürfen geschützte Inhalte lesen. Blockierte/abgebrochene Schritte, nicht zugeordnete Administratoren, Antragsteller und alle API-Keys gewähren keinen Inhaltszugriff. Aktuelle Rechte werden bei jedem Aufruf und jeder Wiederholung geprüft. Listen und Cursor beachten dieselbe Grenze. Neue Live-Vorgänge speichern Nachweise drei Kalendermonate im Free-Tarif oder zwölf in Bezahlmodellen nach Abschluss. Laufende Live-Vorgänge verfallen nicht altersbedingt. Bestehende längere Fristen bleiben erhalten. Sandbox bleibt bei 30 Tagen ab Erstellung.

## GET /v1/flow-runs/{runId}/history

Authentication: restricted integration key (scope: runs:read) or flow2act sign-in access token
Required tenant header: X-Organization-Id.
Required user permissions: Passende Freigabegruppe erforderlich. The API checks current membership, roles, key scopes and resource permissions on every request. Documentation visibility grants no access.

## Request example (replace example IDs)

```sh
curl "https://api.flow2act.com/v1/flow-runs/10000000-0000-4000-8000-000000000004/history" \
  -H "authorization: Bearer $FLOW2ACT_API_KEY" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001"
```

## Response excerpt

```json
[
  {
    "sequence": 1,
    "type": "run.started",
    "runId": "10000000-0000-4000-8000-000000000004",
    "details": {}
  }
]
```

Source: /docs/history
Full schemas: /docs/openapi.json