# Flowg8 · Nutzerimport-Fortschritt

Lies dauerhaften Fortschritt, Personen-IDs und Einladungsfehler.

Ausstehende Arbeit übersteht API-Neustarts. Live-Einladungen werden global höchstens alle zwei Sekunden verarbeitet, mit Wiederholungen und globaler Pause bei Provider-Limits. Sandbox simuliert Einrichtung und Annahme ohne Cognito oder E-Mail. completed bestätigt abgeschlossene Einrichtungsanfragen, keinen Posteingang oder Erstlogin. Personen-IDs stehen sofort bereit; identityId kann bis zur echten Einladungsannahme null bleiben.

Nutze in Live eine Administratorsitzung und in der Sandbox eine Administrator-/Entwicklersitzung. Integrationen benötigen einen Servicekonto-Schlüssel mit organization:write UND users:invite. Schlüssel dürfen nur Importe desselben Servicekontos lesen/wiederholen. Zugriffe werden während der Hintergrundverarbeitung erneut geprüft.

## GET /v1/organization/user-imports/{importId}

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

## Request example (replace example IDs)

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

## Response excerpt

```json
{
  "id": "import-uuid",
  "status": "completed",
  "total": 2,
  "processed": 2
}
```

Source: /docs/get-user-import
Full schemas: /docs/openapi.json