Users

Update an existing user's profile.

Changed on

Two callers share this endpoint. User management updates anyone, any field. A user without it may update only themselves, and only the HashSet<string> UsersController.SelfServiceFields — a body carrying an administrative field (role, type, credentials, mentorship, display order) is rejected outright rather than partially applied, so an escalation attempt never looks like a successful save.

put/Users/{id}

Request

Path parameters

idstring required

User ID (Firebase UID)

Request body

firstNamestring nullable
lastNamestring nullable
displayNamestring nullable
typeinteger
roleIdstring nullable
mentorIdstring nullable
clearMentorboolean nullable
deaNumberstring nullable
licenseNumberstring nullable
licenseStatestring nullable
usdaNumberstring nullable
deaLicenseExpiryDatestring date-time nullable
stateLicenseExpiryDatestring date-time nullable
usdaLicenseExpiryDatestring date-time nullable
signatureImagestring nullable

The provider's stored signature as a data:image/...;base64, data URL. Send an empty string to clear the signature, a data URL to set it, or omit to leave unchanged.

defaultExamTemplateIdstring nullable

Provider's selected default exam template id. Send empty string to clear (use built-in 7-system view) or omit to leave unchanged.

noteStyleInstructionsstring nullable

This clinician's personal note house style. Send an empty string to clear it (fall back to the practice preference alone) or omit to leave unchanged.

Response

Updated user profile

idstring
emailstring
displayNamestring nullable
firstNamestring
lastNamestring
typeinteger
createdAtstring date-time
updatedAtstring date-time nullable
lastLoginAtstring date-time nullable
isActiveboolean
roleIdstring nullable
roleNamestring nullable
permissionsstring[] nullable
invitedAtstring date-time nullable
passwordResetRequiredboolean
mentorIdstring nullable
mentorNamestring nullable
mentorshipStartDatestring date-time nullable
isMentorshipActiveboolean
isPrimaryProviderboolean
careTeamRolestring nullable

The care-team role (a CareTeamRole name) this user defaults to when added to an appointment's care team (ITE-1060): the role's explicit mapping, else the fallback from CareTeamRoles.DefaultFor. Lets the care-team picker show the same default the server would apply.

deaNumberstring nullable
licenseNumberstring nullable
licenseStatestring nullable
usdaNumberstring nullable
deaLicenseExpiryDatestring date-time nullable
stateLicenseExpiryDatestring date-time nullable
usdaLicenseExpiryDatestring date-time nullable
signatureImagestring nullable

The provider's stored signature as a data:image/...;base64, data URL, applied to generated documents (e.g. the vaccine certificate). Null when none on file.

defaultExamTemplateIdstring nullable

Provider's selected default exam template id, or null to use the built-in 7-system view.

noteStyleInstructionsstring nullable

This clinician's personal note house style, or null when they defer entirely to the practice-wide setting. Applied on top of the practice preference, never instead of it.

Changes

    • info

      added the optional property to the response with the status (media type: text/plain)

    • info

      added the optional property to the response with the status (media type: application/json)

    • info

      added the optional property to the response with the status (media type: text/json)

    • info

      added the new optional request property (media type: application/json)

    • info

      added the new optional request property (media type: text/json)

    • info

      added the new optional request property (media type: application/*+json)

    • info

      added the optional property to the response with the status (media type: text/plain)

    • info

      added the optional property to the response with the status (media type: application/json)

    • info

      added the optional property to the response with the status (media type: text/json)