# Flowg8 · Service accounts

List organization-owned integration identities in the selected environment.

Live administrators manage Live accounts. Administrators and explicitly granted Sandbox developers manage Sandbox accounts. Service keys cannot manage accounts, grant access, create keys or approve gates. An account belongs to exactly one workspace and environment.

## GET /v1/service-accounts

Authentication: FLOWG8_ACCESS_TOKEN from Flowg8 sign-in
Required tenant header: X-Organization-Id.
Required user permissions: Administrator or Sandbox developer 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/service-accounts" \
  -H "authorization: Bearer $FLOWG8_ACCESS_TOKEN" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001"
```

## Response excerpt

```json
{
  "items": [
    {
      "id": "10000000-0000-4000-8000-000000000010",
      "name": "ERP onboarding",
      "scopes": [
        "users:invite"
      ],
      "active": true,
      "revision": 1
    }
  ]
}
```

Source: /docs/service-accounts
Full schemas: /docs/openapi.json