# flow2act · Entwurf mit KI erzeugen

Erzeuge einen validierten Vorschlag. Ein Administrator muss ihn prüfen und ausdrücklich speichern.

DeutschlandGPT verwendet ein geprüftes EU-gehostetes Modell. Unterstützt Freigaben, Kenntnisnahmen, Benachrichtigungen, Dokumentfelder und approved/rejected/completed-Enden. Es wird nichts veröffentlicht oder ausgeführt.

KI ist je Organisation und Umgebung standardmäßig deaktiviert. Ein Administrator muss die externe KI-Verarbeitung unter Organisation → Datenschutz ausdrücklich einschalten. Keine Zugangsdaten oder vertraulichen personenbezogenen Inhalte eingeben. Lokale Stichwortsuche bleibt mit smart=false verfügbar.

## POST /v1/ai/flow-suggestions

Authentication: FLOW2ACT_ACCESS_TOKEN from flow2act sign-in
Required tenant header: X-Organization-Id.
Required user permissions: Administrator oder Sandbox-Entwickler erforderlich. The API checks current membership, roles, key scopes and resource permissions on every request. Documentation visibility grants no access.

## Input parameters
- prompt (string, required): min length 12 · max length 3000
- locale (string, optional): en | de · default "en"

## Request example (replace example IDs)

```sh
curl -X POST "https://api.flow2act.com/v1/ai/flow-suggestions" \
  -H "authorization: Bearer $FLOW2ACT_ACCESS_TOKEN" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \
  -H "content-type: application/json" \
  --data-raw '{
  "prompt": "Operations approves every production deployment. Ask for environment and release version.",
  "locale": "en"
}'
```

## Response excerpt

```json
{
  "questions": [],
  "warnings": []
}
```

Source: /docs/generate-flow
Full schemas: /docs/openapi.json
