Ausführungen & Freigaben

Prozess starten

Starte die Ausführung einer veröffentlichten Version. Die Daten müssen deren Felddefinition entsprechen.

POST/v1/flow-runs

Rolle requester erforderlichIntegrationsschlüssel: runs:start; 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

Optionales documentIds enthält bestätigte Reservierungen derselben startenden Identität und veröffentlichten Flow-Version. Pflichtfelder, Dateianzahl, Ablauf und Mandant werden atomar geprüft. Jedes Dokument kann nur einem Vorgang zugeordnet werden. Prozessdaten enthalten keine Dokument-URL.

flowVersionId: veröffentlichte Versions-UUID, keine Flow-ID. referenceId: Referenz im eigenen System, 1–128 Zeichen, eindeutig pro veröffentlichter Version im Workspace. data: skalare Werte unter dem Feldschlüssel; unbekannte Felder werden abgewiesen. Idempotenz verhindert doppelte Starts.

Ein erfolgreich gestarteter Prozess verbraucht einen Request, unabhängig von API-Aufrufen oder Gate-Anzahl. Free enthält 25 pro monatlichem Nutzungszeitraum. Bestehende Prozesse können nach Erreichen des Startlimits abgeschlossen werden.

Freigabeknoten unterstützen assignment=requester_manager mit groupId=null. Integrationen mit runs:start können requesterPersonId (Personen-ID im Organigramm) angeben. Die direkte Führungskraft benötigt einen aktiven Benutzerzugang. Fehlt sie, folgt 409 MANAGER_UNAVAILABLE. Der Empfänger wird beim Aktivieren des Schritts festgehalten.

Liefert auch bei Wiederholungen einen Beleg mit data={} und leerer referenceId. Nur zugeordnete Freigebende/Reviewer können anschließend die Antragsinhalte abrufen.

Request-Body

flowVersionIdstringerforderlichuuid

referenceIdstringerforderlichmin length 1 · max length 128

requesterPersonIdstringoptionaluuid

dataobjecterforderlich

documentIdsarrayoptionalmax items 100

Pflichtfelder & vollständiges Validierungsschema → OpenAPI

Grundlagen des Aufrufs

Authorization: Bearer $FLOW2ACT_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.flow2act.com/v1/flow-runs" \ -H "authorization: Bearer $FLOW2ACT_API_KEY" \ -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \ -H "idempotency-key: example-start-run-001" \ -H "content-type: application/json" \ --data-raw '{ "flowVersionId": "10000000-0000-4000-8000-000000000003", "referenceId": "deployment-example-001", "data": { "environment": "production" } }'

Ausführungen & Freigaben

Prozess starten

Starte die Ausführung einer veröffentlichten Version. Die Daten müssen deren Felddefinition entsprechen.

POST/v1/flow-runs

Rolle requester erforderlichIntegrationsschlüssel: runs:start; 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

Liefert auch bei Wiederholungen einen Beleg mit data={} und leerer referenceId. Nur zugeordnete Freigebende/Reviewer können anschließend die Antragsinhalte abrufen.

Request-Body

flowVersionIdstringerforderlichuuid

referenceIdstringerforderlichmin length 1 · max length 128

requesterPersonIdstringoptionaluuid

dataobjecterforderlich

documentIdsarrayoptionalmax items 100

Pflichtfelder & vollständiges Validierungsschema → OpenAPI

Grundlagen des Aufrufs

Authorization: Bearer $FLOW2ACT_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.

Prozess starten

So funktioniert es

Request-Body

Grundlagen des Aufrufs

Dokumentation fragen

Prozess starten

So funktioniert es

Request-Body

Grundlagen des Aufrufs

Dokumentation fragen