Flows

Flow erstellen

Erstelle ein Designer-Dokument mit typisierten Feldern und Node-Graph. Dies speichert einen Entwurf und startet keinen Prozess.

POST/v1/designer-flows

Administrator oder Sandbox-Entwickler erforderlichIntegrationsschlüssel: flows:write; oder User-Token mit erforderlicher Rolle.

Melde dich an, um die erforderlichen Rechte mit deinem Konto zu vergleichen. Die vollständige Referenz bleibt verfügbar.

So funktioniert es

Ersetze die Beispiel-groupId durch eine vorhandene Workspace-Freigabegruppe. Maximal 30 Felder (Text, Zahl, Boolean, ISO-Datum, Auswahl) und 40 Nodes (start, condition, approval, end).

Bedingungen referenzieren Feldschlüssel mit all/any und eq, neq, gt, gte, lt, lte oder contains. Interne Freigabe-Nodes referenzieren groupId. Externe verwenden groupId:null und externalApprover:{source:„email“,email:„reviewer@example.com“} oder {source:„field“,field:„recipientEmail“,allowedDomains:[„example.com“]}. Das referenzierte Feld muss ein Text-/E-Mail-Pflichtfeld sein. sharedFields benennt extern sichtbare Antragsfelder (Standard []). Verbinde vor Veröffentlichung alle Ausgänge. Schleifen und unerreichbare Nodes werden abgewiesen.

Freigabe-Ausgänge: next führt bei Genehmigung weiter, rejectedNext bei Ablehnung. Verbinde beide bei neuen Flows. Beide können zu einer Bedingung, einer weiteren Freigabe oder einem Ende führen. Ohne rejectedNext bleibt die bisherige sofortige Ablehnung erhalten; null ist ein unverbundener Entwurfsausgang und verhindert die Veröffentlichung. Nur Gates auf dem tatsächlichen Entscheidungspfad werden aktiv.

Alternative für reine Definitionen: POST /v1/flows {name, definition}; POST /v1/flows/{flowId}/versions {definition}; POST /v1/flow-versions/{versionId}/publish {}. Beide Schema-Versionen werden unterstützt.

Request-Body

namestringerforderlichmin length 1 · max length 120

accessScopestringoptionalmin length 1 · max length 60

definitionobjecterforderlich

presentationobjecterforderlich

Pflichtfelder & vollständiges Validierungsschema → OpenAPI

Grundlagen des Aufrufs

Authorization: Bearer $FLOWG8_API_KEY
X-Organization-Id: Deine Workspace-UUID
Idempotency-Key: Stabil pro Vorgang; 8–128 Zeichen

Fragen zur Umsetzung?Frage zu diesem Endpunkt. Antworten enthalten Quellen.

curl -X POST "https://api.flowg8.io/v1/designer-flows" \ -H "authorization: Bearer $FLOWG8_API_KEY" \ -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \ -H "idempotency-key: example-create-flow-001" \ -H "content-type: application/json" \ --data-raw '{ "name": "Deployment approval", "definition": { "schemaVersion": 2, "fields": [ { "key": "environment", "label": "Environment", "type": "select", "required": true, "options": [ "staging", "production" ], "min": null, "max": null } ], "nodes": [ { "id": "start", "type": "start", "label": "Request received", "next": "approval" }, { "id": "approval", "type": "approval", "label": "Operations approval", "groupId": "10000000-0000-4000-8000-000000000009", "next": "end" }, { "id": "end", "type": "end", "label": "Approved", "outcome": "approved" } ] }, "presentation": { "names": { "api": "Request", "amount": "Condition", "end": "Complete" }, "description": "Operations approves a deployment.", "positions": {} } }'

Flows

Flow erstellen

Erstelle ein Designer-Dokument mit typisierten Feldern und Node-Graph. Dies speichert einen Entwurf und startet keinen Prozess.

POST/v1/designer-flows

Administrator oder Sandbox-Entwickler erforderlichIntegrationsschlüssel: flows:write; oder User-Token mit erforderlicher Rolle.

Melde dich an, um die erforderlichen Rechte mit deinem Konto zu vergleichen. Die vollständige Referenz bleibt verfügbar.

So funktioniert es

Ersetze die Beispiel-groupId durch eine vorhandene Workspace-Freigabegruppe. Maximal 30 Felder (Text, Zahl, Boolean, ISO-Datum, Auswahl) und 40 Nodes (start, condition, approval, end).

Request-Body

namestringerforderlichmin length 1 · max length 120

accessScopestringoptionalmin length 1 · max length 60

definitionobjecterforderlich

presentationobjecterforderlich

Pflichtfelder & vollständiges Validierungsschema → OpenAPI

Grundlagen des Aufrufs

Authorization: Bearer $FLOWG8_API_KEY
X-Organization-Id: Deine Workspace-UUID
Idempotency-Key: Stabil pro Vorgang; 8–128 Zeichen

Fragen zur Umsetzung?Frage zu diesem Endpunkt. Antworten enthalten Quellen.

Flow erstellen

So funktioniert es

Request-Body

Grundlagen des Aufrufs

Dokumentation fragen

Flow erstellen

So funktioniert es

Request-Body

Grundlagen des Aufrufs

Dokumentation fragen