# Flowg8 · Fehler & Request-IDs

Fehler verwenden RFC 9457 application/problem+json mit type, title, status, detail, instance sowie den kompatiblen Feldern error, message, requestId. Bewahre X-Request-Id für die Fehlersuche auf; beachte Retry-After bei 429/503.

400 ungültige Eingabe; 401 ungültiger/abgelaufener Zugang; 402 Kontingent oder Billing-Sperre; 403 fehlende Rolle, Mitgliedschaft oder Scopes; 404 Ressource fehlt; 409 Konflikt/veraltete Revision oder Sandbox-Limit/abgelaufene Freigabe; 410 abgelaufene Sandbox-Befehlsdaten; 429 KI-Limit; 502 ungültige KI-Antwort; 503 Dienst nicht verfügbar.

Lade bei Konflikten die aktuelle Revision. Wiederhole vorübergehende Fehler mit begrenztem Backoff und ursprünglichem Idempotency-Key. Wiederhole Schreibaufrufe nie automatisch mit neuen Schlüsseln.

## Request example (replace example IDs)

```sh
curl "https://api.flowg8.io/v1/access" \
  -H "authorization: Bearer $FLOWG8_API_KEY" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001"
```

## Response excerpt

```json
{
  "error": "CONFLICT",
  "message": "The draft has changed",
  "requestId": "example-request-id"
}
```

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