Update an employee
PUT/employees/:id
Partial update — only the fields you send change; omitted fields are left intact (no blanking). Send the current version via the If-Match header (preferred; from the ETag of a prior read) or the body _version. Missing → 400; stale → 409. Any foreign key you set must exist in your organization, or the write is rejected with 422.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 422
- 429
A single employee
Response Headers
Current record version; send back as If-Match on update/delete.
RFC 7807 problem
Missing/invalid/unknown/revoked API key. Note: returned by the gateway as {"message":"Unauthorized"}, NOT RFC 7807, and without X-Request-Id.
RFC 7807 problem
RFC 7807 problem
RFC 7807 problem
RFC 7807 problem
Rate limit exceeded for this organization/environment (tenantId#environment). Note: enforced by the API gateway, so the body is gateway-shaped ({"message":"Limit Exceeded"}), NOT RFC 7807, and without X-Request-Id.