# Flowg8 · Prüfdokumente auflisten

Lies Dokumentmetadaten eines Vorgangs, den du freigeben darfst.

Nur User-Token zugeordneter Freigebender; runs:read-Schlüssel, Administratoren und Antragsteller ohne passenden aktivierten Freigabeschritt erhalten 403. Diese Antwort enthält keine Upload-URLs, Speicherschlüssel oder externen URLs. Leere Liste bedeutet keine verfügbaren Dokumente.

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}/documents

Authentication: FLOWG8_ACCESS_TOKEN from Flowg8 sign-in
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.flowg8.io/v1/flow-runs/10000000-0000-4000-8000-000000000004/documents" \
  -H "authorization: Bearer $FLOWG8_ACCESS_TOKEN" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001"
```

## Response excerpt

```json
{
  "items": []
}
```

Source: /docs/document-list
Full schemas: /docs/openapi.json