# Flowg8 · Organisationsverzeichnis

Lies Personen, Einheiten, Führungslinien und HR-Kontakte.

Der Gründer wird automatisch angelegt. Nutze Nutzer einladen für Konten; reine Verzeichnisprofile erstellen keine Logins und erteilen keine Freigaberechte. Führungskraft und HR sind Verzeichnisdaten; Gates lösen sie noch nicht dynamisch auf.

## GET /v1/organization/directory

Authentication: restricted integration key (scope: organization:read) or Flowg8 sign-in access token
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.

## Request example (replace example IDs)

```sh
curl "https://api.flowg8.io/v1/organization/directory" \
  -H "authorization: Bearer $FLOWG8_API_KEY" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001"
```

## Response excerpt

```json
{
  "organization": {
    "id": "10000000-0000-4000-8000-000000000001",
    "name": "Example workspace",
    "revision": 1
  },
  "people": [],
  "units": []
}
```

Source: /docs/directory
Full schemas: /docs/openapi.json