# flow2act · Servicekonto ändern

Benenne, beschränke, deaktiviere oder reaktiviere eine Integrationsidentität.

Sende die aktuelle Revision. Eine Deaktivierung macht alle Kontoschlüssel für nachfolgende Anfragen ungültig. Reduzierte Scopes machen darüber hinausgehende Schlüssel ungültig. Reaktivieren oder Erweitern kann nicht widerrufene, gültige Schlüssel wieder nutzbar machen. Widerrufe einzelne Schlüssel ausdrücklich, um ihre Wiederverwendung zu verhindern. Der Ersteller bleibt Audit-Metadatum: Service-Schlüssel bleiben beim Ausscheiden dieser Person gültig. Bestehende Schlüssel ohne serviceAccountId bleiben erstellergebunden.

## PUT /v1/service-accounts/{serviceAccountId}

Authentication: FLOW2ACT_ACCESS_TOKEN from flow2act sign-in
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.

## Input parameters
- name (string, required): min length 1 · max length 80
- scopes (array, required): min items 1 · max items 7
- active (boolean, required): 
- revision (integer, required): min 1 · max 9007199254740991

## Request example (replace example IDs)

```sh
curl -X PUT "https://api.flow2act.com/v1/service-accounts/10000000-0000-4000-8000-000000000010" \
  -H "authorization: Bearer $FLOW2ACT_ACCESS_TOKEN" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \
  -H "idempotency-key: example-update-service-account-001" \
  -H "content-type: application/json" \
  --data-raw '{
  "name": "ERP onboarding",
  "scopes": [
    "users:invite"
  ],
  "active": false,
  "revision": 1
}'
```

Source: /docs/update-service-account
Full schemas: /docs/openapi.json