# Flowg8 · Organization directory

Read people, units, reporting lines and HR contacts.

The founder is seeded automatically. Use Invite a user for login accounts; directory-only profiles create no logins and grant no approval rights. Manager and HR links are directory data; workflow gates do not yet resolve them dynamically.

## 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: Active workspace membership required. 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