# Flowg8 · Sandbox-Umgebungen

Entwickle mit isolierten Testdaten, ohne Live zu verändern.

Nutze deine Live-Organisations-ID mit GET /v1/sandbox, um die Sandbox-Workspace-ID zu erhalten. Alle normalen Endpunkte nutzen die zurückgegebene ID in X-Organization-Id. Beide Modi verwenden dieselbe API-Basis-URL. API-Keys können Umgebungen weder ermitteln noch erstellen.

Sandbox-Flows, Versionen, Ausführungen, Entscheidungen, Gruppen, Organisationsprofile, Schlüssel, Audit-Verlauf, KI-Budgets und Idempotenz-Datensätze sind von Live getrennt. Nichts wird automatisch kopiert. Live-Schlüssel beginnen mit fg_sk_; Sandbox-Schlüssel mit fg_test_. Schlüssel können auch mit fremder Workspace-ID nicht die Umgebung wechseln.

Jede Organisation hat derzeit eine Sandbox mit 100 Prozessstarts pro UTC-Kalendermonat, unabhängig vom Live-Tarif. Abrechnungsänderungen sind nur in Live verfügbar. Angemeldete Mitglieder behalten ihre Organisationsrechte; das Entfernen ihrer Hauptmitgliedschaft entzieht auch Sandbox-Zugriff und deaktiviert ihre Sandbox-Schlüssel.

Sandbox-Regeln: 100 erfolgreiche Starts pro UTC-Kalendermonat, maximal 10 gleichzeitig offene Prozesse. Nur Starts mit ausstehender Freigabe benötigen einen offenen Platz. Offene Anträge laufen 7 Tage nach Erstellung ab (Status expired; verbleibende Gates storniert). Prozessdaten werden 30 Tage nach Erstellung gelöscht, einschließlich Entscheidungen, Verlauf und gespeicherter Befehlsantworten. decisionExpiresAt und expiresAt zeigen feste, nicht verlängerbare Fristen. Flow-Definitionen, Konfiguration und Schlüssel bleiben erhalten. Der Worker bereinigt beim Start und minütlich in begrenzten Paketen; abgelaufene Daten sind auch bei verzögerter Bereinigung sofort nicht mehr zugänglich.

Verbrauchszähler und minimale Idempotenz-Metadaten enthalten keine Prozessnutzdaten und bleiben nach der Löschung bestehen. Abgelaufene Befehlswiederholungen liefern 410 RUN_DATA_EXPIRED und erstellen den Prozess nicht erneut. Noch gespeicherte Sandbox-Befehle liefern bei Wiederholung den aktuellen Prozesszustand statt eines veralteten Waiting-Snapshots. Abschließen, Ablaufen oder Löschen gibt kein Monatskontingent zurück. Gleichzeitige Starts halten beide Limits atomar ein.

Nutze synthetische Daten: Die Sandbox verwendet die echte Freigabe-Engine und Freigabegruppen. Sie anonymisiert keine Daten und simuliert nicht jeden externen Dienst. Konfigurierte Sandbox-Lifecycle-Webhooks senden echte HTTPS-Anfragen an dein Testziel; Freigabe-E-Mails bleiben im Testpostfach. KI bleibt ein echter DeutschlandGPT-Aufruf mit den üblichen Limits.

## GET /v1/sandbox

Authentication: FLOWG8_ACCESS_TOKEN from Flowg8 sign-in
Required tenant header: X-Organization-Id.
Required user permissions: Aktive Workspace-Mitgliedschaft 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/sandbox" \
  -H "authorization: Bearer $FLOWG8_ACCESS_TOKEN" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001"
```

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