So funktioniert es
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.
Grundlagen des Aufrufs
- Authorization
- Bearer $FLOWG8_ACCESS_TOKEN
- X-Organization-Id
- Deine Workspace-UUID