# flow2act · Flows durchsuchen

Finde Flows mit Stichwörtern oder optionaler KI-Sucherweiterung.

Ist KI nicht verfügbar oder limitiert, nutzt die Suche Stichwörter und meldet degraded: true. Schlüssel verwenden stattdessen GET /v1/flows.

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/flows/search

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

## Input parameters
- query (string, required): min length 2 · max length 200
- smart (boolean, optional): default false

## Request example (replace example IDs)

```sh
curl -X POST "https://api.flow2act.com/v1/flows/search" \
  -H "authorization: Bearer $FLOW2ACT_ACCESS_TOKEN" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \
  -H "content-type: application/json" \
  --data-raw '{
  "query": "production deployment approval",
  "smart": true
}'
```

## Response excerpt

```json
{
  "items": [],
  "terms": [
    "deployment"
  ],
  "mode": "keyword",
  "degraded": true
}
```

Source: /docs/search-flows
Full schemas: /docs/openapi.json