# Flowg8 · Freigabegruppe erstellen

Erstelle ein Freigabeteam und wähle Personen aus dem Organisationsverzeichnis.

Erfordert einen Administrator-User-Token; Sandbox-Entwickler dürfen Sandbox-Gruppen verwalten. memberIds sind Personen-IDs aus GET /v1/organization/directory derselben Organisation/Umgebung. Eingeladene Profile dürfen bereits ausgewählt werden; Entscheidungen erfordern einen verknüpften aktiven Nutzer und aktiven Organisationszugang. Leere Gruppen sind zur Vorbereitung zulässig. Nutze die stabile Gruppen-ID in Freigabe-Nodes. Erfordert Idempotency-Key.

## POST /v1/approval-groups

Authentication: FLOWG8_ACCESS_TOKEN from Flowg8 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
- name (string, required): min length 1 · max length 80
- accessScope (string, optional): min length 1 · max length 60 · default "general"
- memberIds (array, optional): max items 1000 · default []

## Request example (replace example IDs)

```sh
curl -X POST "https://api.flowg8.io/v1/approval-groups" \
  -H "authorization: Bearer $FLOWG8_ACCESS_TOKEN" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \
  -H "idempotency-key: example-link-group-001" \
  -H "content-type: application/json" \
  --data-raw '{
  "name": "Operations",
  "memberIds": [
    "10000000-0000-4000-8000-000000000006"
  ]
}'
```

## Response excerpt

```json
{
  "id": "10000000-0000-4000-8000-000000000009",
  "name": "Operations",
  "revision": 1,
  "memberIds": [
    "10000000-0000-4000-8000-000000000006"
  ],
  "needsMemberReview": false
}
```

Source: /docs/link-group
Full schemas: /docs/openapi.json