# flow2act · Dokument-Upload bestätigen

Prüfe Größe, Prüfsumme, Objektversion und erfolgreiche Schadsoftwareprüfung.

Nur dieselbe hochladende Identität darf bestätigen. Erfordert runs:start oder Antragstellerzugang und Idempotency-Key. 409 DOCUMENT_SCAN_PENDING: dieselbe Bestätigung nach kurzer Wartezeit wiederholen. 422 DOCUMENT_SCAN_REJECTED: Datei nicht anhängen, andere wählen. Nur Dokumente mit ready können einen Prozess starten. Fehlgeschlagene Prüfungen gewähren keinen Lesezugriff. Die exakte S3-Version wird bei Bestätigung festgehalten.

## POST /v1/documents/{documentId}/confirm

Authentication: restricted integration key (scope: runs:start) or flow2act sign-in access token
Required tenant header: X-Organization-Id.
Required user permissions: Rolle requester 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 -X POST "https://api.flow2act.com/v1/documents/10000000-0000-4000-8000-000000000012/confirm" \
  -H "authorization: Bearer $FLOW2ACT_API_KEY" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \
  -H "idempotency-key: example-document-confirm-001" \
  -H "content-type: application/json" \
  --data-raw '{}'
```

## Response excerpt

```json
{
  "id": "10000000-0000-4000-8000-000000000012",
  "status": "ready"
}
```

Source: /docs/document-confirm
Full schemas: /docs/openapi.json