Skip to main content
PATCH

Authorizations

X-API-Key
string
header
required

Owner-typed API key (ORGANIZATION, PERSON, VALUE_UNIT). Manage org-scoped lifecycle with /v1/public-api-keys; cross-org governance is restricted to /v1/sys/public-api-keys.

Path Parameters

id
string
required

Body

application/merge-patch+json

Merge-patch payload for mutable person fields. Omitted fields remain unchanged. Explicit null clears managerId, externalId, and jobTitle. Resolve organizationalUnitId via GET /v1/public/organizational-units and managerId via GET /v1/public/people.

firstName
string | null
lastName
string | null
email
string | null
externalId
string | null
jobTitle
string | null
organizationalUnitId
string | null

Organizational unit id in the authenticated organization.

Example:

"a5ec8a9e-b6a9-4230-9ce9-8db4bb40f6ff"

managerId
string | null

Manager id in the authenticated organization.

Example:

"2f6db7d4-6e6c-4d4f-90f2-cbaac8441f7b"

basedIn
string | null
timeZoneName
string | null

Response

Person updated

id
string
firstName
string
lastName
string
email
string
externalId
string
jobTitle
string
organizationalUnitId
string
organizationalUnitName
string
managerId
string
managerName
string
joined
string<date-time>
basedIn
string
timeZoneName
string
groups
object[]
teams
object[]
workloadScheme
object
holidayScheme
object
deleted
boolean