Organization

Update a person

Replace all editable person fields and send the current revision.

PUT/v1/organization/people/{personId}

Administrator or Sandbox developer requiredIntegration key: organization:write; or a user token with the required role.

How it works

Send full input fields, not id, createdAt or updatedAt. Cycles, inactive references, foreign workspace links and stale revisions are rejected.

Request body

displayNamestringrequiredmin length 1 · max length 120

emailstringrequiredemail · max length 254

jobTitlestringrequiredmax length 120 · default ""

externalIdstringrequiredmin length 1 · max length 120 · default null

unitIdstringrequireduuid · default null

managerIdstringrequireduuid · default null

hrPersonIdstringrequireduuid · default null

identityIdstringrequireduuid · default null

activebooleanrequireddefault true

revisionintegerrequiredmin 1 · max 9007199254740991

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOWG8_API_KEY
X-Organization-Id: Your workspace UUID
Idempotency-Key: Stable per operation; 8–128 characters

Have an implementation question?Ask about this endpoint. Answers include source references.

curl -X PUT "https://api.flowg8.io/v1/organization/people/10000000-0000-4000-8000-000000000006" \ -H "authorization: Bearer $FLOWG8_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 }'

{ "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 } ] }

Organization

Update a person

Replace all editable person fields and send the current revision.

PUT/v1/organization/people/{personId}

Administrator or Sandbox developer requiredIntegration key: organization:write; or a user token with the required role.

How it works

Send full input fields, not id, createdAt or updatedAt. Cycles, inactive references, foreign workspace links and stale revisions are rejected.

Request body

displayNamestringrequiredmin length 1 · max length 120

emailstringrequiredemail · max length 254

jobTitlestringrequiredmax length 120 · default ""

externalIdstringrequiredmin length 1 · max length 120 · default null

unitIdstringrequireduuid · default null

managerIdstringrequireduuid · default null

hrPersonIdstringrequireduuid · default null

identityIdstringrequireduuid · default null

activebooleanrequireddefault true

revisionintegerrequiredmin 1 · max 9007199254740991

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOWG8_API_KEY
X-Organization-Id: Your workspace UUID
Idempotency-Key: Stable per operation; 8–128 characters

Have an implementation question?Ask about this endpoint. Answers include source references.

Update a person

How it works

Request body

Request essentials

Ask the docs

Update a person

How it works

Request body

Request essentials

Ask the docs