API explorerChangelog
Overview

Sections

API explorer
Changelog

Theme switcher

Update user

The method allows you to overwrite the details of an existing user in MyPreferences.

Properties not included in the request will be treated as blank, and will not be retained in the updated user account.

Header Parameters

Authorizationstring

Authorization token.

Content-Typestring

Media type indicating that the content is in JSON format.

Path Parameters

clientIdstring

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

usernamestring

The unique username of the user to update.

Body Parameters

Phonestring

The user's contact phone number.

Descriptionstring

An optional text field for storing additional information or notes about the user.

UserNamestring

The unique login identifier for the user.

FirstNamestring

The user's given name.

LastNamestring

The user's family or surname.

Emailstring

The user's email address.

UserGroupsarray

Show child attributes

SourceGroupIDstring

The ID of the Source Group associated with the user.

DefaultLandingPagestring

The default page the user is directed to upon login. Options include Dashboard, ProfileSearch, and DataExport.

DefaultLandingPageTypeNbrnumber

A numeric code representing the type or category of the landing page.

IsSSOboolean

Indicates whether the new user is an SSO user. If set to true, user registration email will not be sent.

This property is only used during user creation. It does not reflect the SSO status of an existing user and will not modify any existing user data.

IsActiveboolean

Indicates whether the user account is currently active (true) or deactivated (false).

Response

202
Object
Accepted
400
Object
The request was invalid and cannot be processed. This error may occur as a result of a malformed or syntactically incorrect request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect.
403
Object
API user does not have appropriate permissions to access the requested resource.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
409
Object
The request could not be completed due to a conflict with the current state of the target resource. In most cases, an instance with the same already exists on the target resource. You must update the request before trying again.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

PUT

/

Select
1

Response

Was this section helpful?

What made this section unhelpful for you?