user

Edit User

Changed on

Edit existing User

put/user/{userId}

Request

  • Base URL
    /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/user/{userId}
  • Auth
    none declared

Path parameters

userIdinteger required

The user ID to edit

Request body application/x-www-form-urlencoded

userNamestring required

The User Name

emailstring

The user email address

userTypeIdinteger required

The user type ID

homePageId'statusdashboard.view' | 'icondashboard.view' | 'mediamanager.view' | 'playlistdashboard.view' required

The homepage to use for this User

libraryQuotainteger

The users library quota in kilobytes

newPasswordstring

New User password

retypeNewPasswordstring

Repeat the new User password

retiredinteger

Flag indicating whether to retire this user

firstNamestring

The users first name

lastNamestring

The users last name

phonestring

The users phone number

ref1string

Reference 1

ref2string

Reference 2

ref3string

Reference 3

ref4string

Reference 4

ref5string

Reference 5

newUserWizardinteger required

Flag indicating whether to show the new user guide

hideNavigationinteger required

Flag indicating whether to hide the navigation

isPasswordChangeRequiredinteger

A flag indicating whether password change should be forced for this user

Response

successful operation

userIdinteger

The ID of this User

userNamestring

The user name

userTypeIdinteger

The user type ID

loggedIninteger

Flag indicating whether this user is logged in or not

emailstring

Email address of the user used for email alerts

homePageIdinteger

The pageId of the Homepage for this User

homeFolderIdinteger

This users home folder

lastAccessedinteger

A timestamp indicating the time the user last logged into the CMS

newUserWizardinteger

A flag indicating whether this user has see the new user wizard

retiredinteger

A flag indicating whether the user is retired

isPasswordChangeRequiredinteger

A flag indicating whether password change should be forced for this user

groupIdinteger

The users user group ID

groupinteger

The users group name

libraryQuotainteger

The users library quota in bytes

firstNamestring

First Name

lastNamestring

Last Name

phonestring

Phone Number

ref1string

Reference field 1

ref2string

Reference field 2

ref3string

Reference field 3

ref4string

Reference field 4

ref5string

Reference field 5

playlistsunknown
isSystemNotificationinteger

Does this User receive system notifications.

isDisplayNotificationinteger

Does this User receive system notifications.

isDataSetNotificationinteger

Does this User receive DataSet notifications.

isLayoutNotificationinteger

Does this User receive Layout notifications.

isLibraryNotificationinteger

Does this User receive Library notifications.

isReportNotificationinteger

Does this User receive Report notifications.

isScheduleNotificationinteger

Does this User receive Schedule notifications.

isCustomNotificationinteger

Does this User receive Custom notifications.

twoFactorTypeIdinteger

The two factor type id

twoFactorSecretstring

Two Factor authorisation shared secret for this user

twoFactorRecoveryCodesstring[]

Two Factor authorisation recovery codes

Changes

  • 622fb073aecdRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property // to the response with the status

  • 41c04de98ec5Revision changes
    • breaking

      added required request body

    • info

      added the media type application/json for the response with the status