patch
https://api.cert.zerohash.com/participants/entity//users/
Update one or more fields of an existing Entity user (Control Person, Beneficial Owner, or Board Member). This is a partial update endpoint - only the fields provided in the request body will be updated.
Important notes:
Platform configuration:
- Your platform must be properly configured before using this endpoint.
PII changes and document requirements:
- When users are updated with new identifying information (such as
first_name,last_name,date_of_birth, orcitizenship_code), these changes must be accompanied by supporting documentation. - Use the Submit Documents endpoint with the appropriate document type to provide supporting documents.
Compliance field updates:
- Updating KYC-related fields (
sanction_screening,kyc,id_number_type, etc.) may require re-verification depending on your platform configuration. - Changes to identity documents or verification status may trigger additional compliance checks.
Vendor reliance track:
- For platforms using vendor reliance track,
sanction_screeningandkycfields must be provided with vendor verification results. sanction_screening_timestampandkyc_timestampshould be set to the time when the vendor completed the verification (in milliseconds since Unix epoch).
Conditional requirements:
- If
id_number_typeisnon_us_other, thenon_us_other_typefield is required to describe the ID type. - For non-US citizens or when
tax_idis an ITIN (begins with 9),id_number_typeandid_numberare required.
Response:
Returns the complete user object with all fields, including unchanged fields and system-generated metadata.
