# flow2act · 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: FLOW2ACT_ACCESS_TOKEN from flow2act 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.flow2act.com/v1/service-accounts" \
  -H "authorization: Bearer $FLOW2ACT_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