Updates the name, email, phone, role or photo of a school user (an administrator or collaborator account) in place, so the account keeps its history. Only the fields sent are changed; at least one is required. Re-sending the current values of name, email, phone and role succeeds with an empty updatedFields; photoUrl is the exception: a URL sent is always processed again (the image behind it may have changed) and is then listed. The user is looked up in the API key's school: a user of another school, or a deleted one, answers 404 USER_NOT_FOUND (list the ids with GET /v1/users).
Permission: the API key needs the update level on users, as POST /v1/users does; an OAuth token cannot use this endpoint (403).
Email: unique among the users of the school, compared ignoring case (409 USER_ALREADY_EXISTS); the same address in another school is allowed, that is how one person holds accounts in several schools. An effective change locks the account until the owner of the new address activates it: the password is cleared, every session is closed and the new-collaborator invitation is sent to the new address, following the school's invitation setting. Nothing is sent to the old address. The same address in another case or with surrounding spaces is a no-op.
Role: ANALYST, USER or ADMIN, never OWNER. A change applies on the user's next request; leaving the USER role clears the group restriction and its audience type.
Photo: photoUrl is downloaded, checked, scanned for viruses, resized and stored by Edusign after the response, like student photos; a failure (unreachable URL, not an image, infected file) leaves the current photo unchanged without changing the response. photoUrl: null removes the photo at once.
The owner: any request on the owner account answers 422 USER_OWNER_EDIT_NOT_ALLOWED and saves nothing, whatever the values sent, as on the platform where only the owner edits it; integrations must skip the owner. Ownership transfer stays a support operation.
This endpoint supersedes POST /v1/users/change-permissions, which stays live. There is no by-reference-id route: school users have no external reference today.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||

