# flow2act · Person aktualisieren

Ersetze alle bearbeitbaren Personenfelder und sende die aktuelle Revision.

Sende vollständige Eingabefelder, keine id-, createdAt- oder updatedAt-Werte. Zyklen, inaktive Referenzen, fremde Workspaces und veraltete Revisionen werden abgewiesen.

## PUT /v1/organization/people/{personId}

Authentication: restricted integration key (scope: organization:write) or flow2act 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.

## Input parameters
- displayName (string, required): min length 1 · max length 120
- email (string, required): email · max length 254
- jobTitle (string, required): max length 120 · default ""
- externalId (string, required): min length 1 · max length 120 · default null
- unitId (string, required): uuid · default null
- managerId (string, required): uuid · default null
- hrPersonId (string, required): uuid · default null
- identityId (string, required): uuid · default null
- active (boolean, required): default true
- revision (integer, required): min 1 · max 9007199254740991

## Request example (replace example IDs)

```sh
curl -X PUT "https://api.flow2act.com/v1/organization/people/10000000-0000-4000-8000-000000000006" \
  -H "authorization: Bearer $FLOW2ACT_API_KEY" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \
  -H "idempotency-key: example-update-person-001" \
  -H "content-type: application/json" \
  --data-raw '{
  "displayName": "Alex Example",
  "email": null,
  "jobTitle": "Senior engineer",
  "externalId": "employee-example",
  "unitId": null,
  "managerId": null,
  "hrPersonId": null,
  "identityId": null,
  "active": true,
  "revision": 1
}'
```

## Response excerpt

```json
{
  "people": [
    {
      "displayName": "Alex Example",
      "email": null,
      "jobTitle": "Engineer",
      "externalId": "employee-example",
      "unitId": null,
      "managerId": null,
      "hrPersonId": null,
      "identityId": null,
      "active": true,
      "id": "10000000-0000-4000-8000-000000000006",
      "revision": 2
    }
  ]
}
```

Source: /docs/update-person
Full schemas: /docs/openapi.json