PUT api/v1/admin/users/{id}

Updates user details of the specified user. The logged in user must have permission to perform this action.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

The ID of the user to be modified.

globally unique identifier

Required

Body Parameters

The new details of the user.

User
NameDescriptionTypeAdditional information
ID

The unique identifier for the user.

globally unique identifier

None.

AgreementDate

The date the user accepted the privacy policy and data processing agreement. This field is read-only.

date

None.

AccountID

The unique identifier for the account.

globally unique identifier

None.

AdminUser

Determines if the user is an admin user.

boolean

None.

DateCreated

The date the user account was created.

date

None.

DateModified

The date the user account was last modified.

date

None.

DeclineDate

The date the user declined the privacy policy and data processing agreement. This field is read-only.

date

None.

DisplayName

The name of the user.

string

Required

DPAVersion

The version of the data processing agreement that the user has accepted. This field is only read-only.

string

None.

EmailAddress

The email address of the user.

string

Required

Data type: EmailAddress

Enabled

Determines the status of the user.

boolean

Required

LanguageID

The Id of the language of the user.

globally unique identifier

Required

MobilePhone

The mobile phone of the user

string

Required

Matching regular expression pattern: ^(?=.*?\d.*?\d.*?\d.*?\d.*?\d)([+]?)([\d\s\(\)-]{5,20})$

Password

The password of the user.

string

None.

Pin

Sets the security pin when two factor has been enable. Set it to null if you want it to randonly generate each login.

string

None.

Preferences

Preferences

None.

PrivacyPolicyVersion

The version of the privacy policy that the user has accepted. This field is only read-only.

string

None.

SSOEnabled

Determines if the user is part of a SSO setup.

boolean

None.

TimeZone

The timezone of the user.

string

Required

Username

The username of the user to log into the system.

string

Required

Request Formats

application/json, text/json

Sample:
{
  "ID": "a2d8b2d2-1673-4f2d-a9ec-b02947160be7",
  "AgreementDate": "2024-03-28T08:12:49.3595132+00:00",
  "AccountID": "5a1ca887-9ec4-4ae8-bf61-715056ea9e98",
  "AdminUser": true,
  "DateCreated": "2024-03-28T08:12:49.3595132+00:00",
  "DateModified": "2024-03-28T08:12:49.3595132+00:00",
  "DeclineDate": "2024-03-28T08:12:49.3595132+00:00",
  "DisplayName": "sample string 6",
  "DPAVersion": "sample string 7",
  "EmailAddress": "sample string 8",
  "Enabled": true,
  "LanguageID": "c2fd9942-2548-483b-875c-a724b208dcaa",
  "MobilePhone": "sample string 12",
  "Password": "sample string 13",
  "Pin": "sample string 14",
  "Preferences": 0,
  "PrivacyPolicyVersion": "sample string 15",
  "SSOEnabled": true,
  "TimeZone": "sample string 17",
  "Username": "sample string 18",
  "UserPassword": "sample string 19"
}

application/xml, text/xml

Sample:
<User xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <ID>a2d8b2d2-1673-4f2d-a9ec-b02947160be7</ID>
  <AgreementDate>2024-03-28T08:12:49.3595132+00:00</AgreementDate>
  <AccountID>5a1ca887-9ec4-4ae8-bf61-715056ea9e98</AccountID>
  <AdminUser>true</AdminUser>
  <DateCreated>2024-03-28T08:12:49.3595132+00:00</DateCreated>
  <DateModified>2024-03-28T08:12:49.3595132+00:00</DateModified>
  <DeclineDate>2024-03-28T08:12:49.3595132+00:00</DeclineDate>
  <DisplayName>sample string 6</DisplayName>
  <DPAVersion>sample string 7</DPAVersion>
  <EmailAddress>sample string 8</EmailAddress>
  <Enabled>true</Enabled>
  <LanguageID>c2fd9942-2548-483b-875c-a724b208dcaa</LanguageID>
  <Language>sample string 11</Language>
  <MobilePhone>sample string 12</MobilePhone>
  <Password>sample string 13</Password>
  <Pin>sample string 14</Pin>
  <Preferences>NONE</Preferences>
  <PrivacyPolicyVersion>sample string 15</PrivacyPolicyVersion>
  <SSOEnabled>true</SSOEnabled>
  <TimeZone>sample string 17</TimeZone>
  <Username>sample string 18</Username>
  <UserPassword>sample string 19</UserPassword>
</User>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

The modified user details.

ResponseOfUser
NameDescriptionTypeAdditional information
Error

Error

None.

ResponseData

ResponseDataOfUser

None.

Response Formats

application/json, text/json

Sample:
{
  "Error": {
    "ErrorCode": "sample string 1",
    "ErrorReason": "sample string 2"
  },
  "ResponseData": {
    "Identification": {
      "UserId": "sample string 1"
    },
    "Result": "sample string 1",
    "Detail": {
      "ID": "cf8c4452-10f2-4439-880c-c89aead2b110",
      "AgreementDate": "2024-03-28T08:12:49.3685073+00:00",
      "AccountID": "b497d834-253a-40aa-b17b-284d624a31c2",
      "AdminUser": true,
      "DateCreated": "2024-03-28T08:12:49.3685073+00:00",
      "DateModified": "2024-03-28T08:12:49.3685073+00:00",
      "DeclineDate": "2024-03-28T08:12:49.3685073+00:00",
      "DisplayName": "sample string 6",
      "DPAVersion": "sample string 7",
      "EmailAddress": "sample string 8",
      "Enabled": true,
      "LanguageID": "8330c1bc-3274-4e9d-9a4b-e15539b687b3",
      "MobilePhone": "sample string 12",
      "Password": "sample string 13",
      "Pin": "sample string 14",
      "Preferences": 0,
      "PrivacyPolicyVersion": "sample string 15",
      "SSOEnabled": true,
      "TimeZone": "sample string 17",
      "Username": "sample string 18",
      "UserPassword": "sample string 19"
    }
  }
}

application/xml, text/xml

Sample:
<ResponseOfUser xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Error>
    <ErrorCode>sample string 1</ErrorCode>
    <ErrorReason>sample string 2</ErrorReason>
  </Error>
  <ResponseData>
    <Result>sample string 1</Result>
    <Identification>
      <UserId>sample string 1</UserId>
    </Identification>
    <Detail>
      <ID>cf8c4452-10f2-4439-880c-c89aead2b110</ID>
      <AgreementDate>2024-03-28T08:12:49.3685073+00:00</AgreementDate>
      <AccountID>b497d834-253a-40aa-b17b-284d624a31c2</AccountID>
      <AdminUser>true</AdminUser>
      <DateCreated>2024-03-28T08:12:49.3685073+00:00</DateCreated>
      <DateModified>2024-03-28T08:12:49.3685073+00:00</DateModified>
      <DeclineDate>2024-03-28T08:12:49.3685073+00:00</DeclineDate>
      <DisplayName>sample string 6</DisplayName>
      <DPAVersion>sample string 7</DPAVersion>
      <EmailAddress>sample string 8</EmailAddress>
      <Enabled>true</Enabled>
      <LanguageID>8330c1bc-3274-4e9d-9a4b-e15539b687b3</LanguageID>
      <Language>sample string 11</Language>
      <MobilePhone>sample string 12</MobilePhone>
      <Password>sample string 13</Password>
      <Pin>sample string 14</Pin>
      <Preferences>NONE</Preferences>
      <PrivacyPolicyVersion>sample string 15</PrivacyPolicyVersion>
      <SSOEnabled>true</SSOEnabled>
      <TimeZone>sample string 17</TimeZone>
      <Username>sample string 18</Username>
      <UserPassword>sample string 19</UserPassword>
    </Detail>
  </ResponseData>
</ResponseOfUser>