# Flowg8 · Deine Organisation

Ermittle deine Organisation nach der Flowg8-Anmeldung.

Nutze FLOWG8_ACCESS_TOKEN aus deiner normalen Flowg8-Anmeldung. Flowg8 verwaltet die Authentifizierung; du brauchst keinen eigenen Identitätsanbieter. Einladungen werden der verifizierten Benutzeridentität zugeordnet; eingeladene Personen treten der bestehenden Organisation bei und erhalten keine neue eigene. Leere Anfragen verwenden die aktive Organisation. Zum Wechsel sende {organizationId} einer aktiven Mitgliedschaft aus GET /v1/workspaces. Entfernte Mitgliedschaften erlauben keinen Zugriff.

## POST /v1/workspace

Authentication: FLOWG8_ACCESS_TOKEN from Flowg8 sign-in
Required user permissions: Flowg8-Anmeldung 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 -X POST "https://api.flowg8.io/v1/workspace" \
  -H "authorization: Bearer $FLOWG8_ACCESS_TOKEN" \
  -H "content-type: application/json" \
  --data-raw '{}'
```

## Response excerpt

```json
{
  "organization": {
    "id": "10000000-0000-4000-8000-000000000001",
    "name": "My workspace"
  },
  "roles": [
    "admin",
    "requester"
  ]
}
```

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