Dokumente

Dokument-Upload reservieren

Fordere eine fünfminütige Upload-Berechtigung für eine unveränderliche Datei an.

POST/v1/documents/uploads

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

Erfordert runs:start oder Antragstellerzugang und Idempotency-Key. Flow-Version muss veröffentlicht und Dokumentfeld/Typ/Größe konfiguriert sein. Lade die echten Dateibytes per PUT auf upload.url und sende alle upload.headers exakt. Sende keinen Flowg8-Token an S3. Die Upload-Berechtigung gewährt keinen Lesezugriff. SHA-256 ist kleingeschriebenes Hex über die exakten Dateibytes; S3 prüft die signierte Prüfsumme und ein bedingter Schreibzugriff verhindert Überschreiben. Die Wiederholung derselben Reservierung kann ihre temporäre Upload-URL erneuern.

Request-Body

flowVersionIdstringerforderlichuuid

fieldKeystringerforderlich

fileNamestringerforderlichmin length 1 · max length 180

contentTypestringerforderlichapplication/pdf | image/png | image/jpeg | application/vnd.openxmlformats-officedocument.wordprocessingml.document

sizeintegererforderlichmin 1 · max 26214400

sha256stringerforderlich

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/documents/uploads" \ -H "authorization: Bearer $FLOWG8_API_KEY" \ -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \ -H "idempotency-key: example-document-upload-001" \ -H "content-type: application/json" \ --data-raw '{ "flowVersionId": "10000000-0000-4000-8000-000000000003", "fieldKey": "contract", "fileName": "contract.pdf", "contentType": "application/pdf", "size": 1234, "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" }'

{ "document": { "id": "10000000-0000-4000-8000-000000000012", "status": "uploading" }, "upload": { "url": "https://private-bucket.s3.eu-central-1.amazonaws.com/<temporary-upload-capability>", "headers": { "content-type": "application/pdf", "x-amz-checksum-sha256": "<base64 checksum>", "if-none-match": "*" }, "expiresAt": "2026-10-18T12:05:00.000Z" } }

Dokumente

Dokument-Upload reservieren

Fordere eine fünfminütige Upload-Berechtigung für eine unveränderliche Datei an.

POST/v1/documents/uploads

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

Request-Body

flowVersionIdstringerforderlichuuid

fieldKeystringerforderlich

fileNamestringerforderlichmin length 1 · max length 180

contentTypestringerforderlichapplication/pdf | image/png | image/jpeg | application/vnd.openxmlformats-officedocument.wordprocessingml.document

sizeintegererforderlichmin 1 · max 26214400

sha256stringerforderlich

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.

Dokument-Upload reservieren

So funktioniert es

Request-Body

Grundlagen des Aufrufs

Dokumentation fragen

Dokument-Upload reservieren

So funktioniert es

Request-Body

Grundlagen des Aufrufs

Dokumentation fragen