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

Name	Description	Type	Additional information
id	The ID of the user to be modified.	globally unique identifier	Required

Body Parameters

The new details of the user.

TwoSms.CustomerPortalRole.API.Admin.Users.User

Name	Description	Type	Additional 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		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		TwoSms.CustomerPortalRole.API.Admin.Users.Preferences	None.
PrivacyPolicyVersion	The version of the privacy policy that the user has accepted. This field is only read-only.	string	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": "4e405219-ab95-454b-9779-ad17fa31ca7a",
  "AgreementDate": "2025-01-18T05:21:49.1825962+00:00",
  "AccountID": "25d6d8c3-7c7e-4716-aa99-f340eed98068",
  "AdminUser": true,
  "DateCreated": "2025-01-18T05:21:49.1825962+00:00",
  "DateModified": "2025-01-18T05:21:49.1825962+00:00",
  "DeclineDate": "2025-01-18T05:21:49.1825962+00:00",
  "DisplayName": "sample string 6",
  "DPAVersion": "sample string 7",
  "EmailAddress": "sample string 8",
  "Enabled": true,
  "LanguageID": "07e36c0e-d165-48bb-9f1e-997bd7c458ad",
  "MobilePhone": "sample string 12",
  "Password": "sample string 13",
  "Pin": "sample string 14",
  "Preferences": 0,
  "PrivacyPolicyVersion": "sample string 15",
  "TimeZone": "sample string 16",
  "Username": "sample string 17"
}

application/xml, text/xml

Sample:

<User xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <ID>4e405219-ab95-454b-9779-ad17fa31ca7a</ID>
  <AgreementDate>2025-01-18T05:21:49.1825962+00:00</AgreementDate>
  <AccountID>25d6d8c3-7c7e-4716-aa99-f340eed98068</AccountID>
  <AdminUser>true</AdminUser>
  <DateCreated>2025-01-18T05:21:49.1825962+00:00</DateCreated>
  <DateModified>2025-01-18T05:21:49.1825962+00:00</DateModified>
  <DeclineDate>2025-01-18T05:21:49.1825962+00:00</DeclineDate>
  <DisplayName>sample string 6</DisplayName>
  <DPAVersion>sample string 7</DPAVersion>
  <EmailAddress>sample string 8</EmailAddress>
  <Enabled>true</Enabled>
  <LanguageID>07e36c0e-d165-48bb-9f1e-997bd7c458ad</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>
  <TimeZone>sample string 16</TimeZone>
  <Username>sample string 17</Username>
</User>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'System.Web.Http.ModelBinding.JQueryMvcFormUrlEncodedFormatter' to write type 'TwoSms.CustomerPortalRole.API.Admin.Users.User'.

Response Information

Resource Description

The modified user details.

TwoSms.CustomerPortalRole.API.Misc.ResponseOfTwoSms.CustomerPortalRole.API.Admin.Users.User

Name	Description	Type	Additional information
Error		TwoSms.CustomerPortalRole.API.Misc.Error	None.
ResponseData		TwoSms.CustomerPortalRole.API.Misc.ResponseDataOfTwoSms.CustomerPortalRole.API.Admin.Users.User	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": "20d1401b-a8cf-4bfd-ab3e-152660ec0b8a",
      "AgreementDate": "2025-01-18T05:21:49.1835947+00:00",
      "AccountID": "f4968e88-1d09-4749-97a1-9574771b5d74",
      "AdminUser": true,
      "DateCreated": "2025-01-18T05:21:49.1835947+00:00",
      "DateModified": "2025-01-18T05:21:49.1835947+00:00",
      "DeclineDate": "2025-01-18T05:21:49.1835947+00:00",
      "DisplayName": "sample string 6",
      "DPAVersion": "sample string 7",
      "EmailAddress": "sample string 8",
      "Enabled": true,
      "LanguageID": "5b5e0766-cbeb-4f19-90d5-4c9b4b784639",
      "MobilePhone": "sample string 12",
      "Password": "sample string 13",
      "Pin": "sample string 14",
      "Preferences": 0,
      "PrivacyPolicyVersion": "sample string 15",
      "TimeZone": "sample string 16",
      "Username": "sample string 17"
    }
  }
}

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>20d1401b-a8cf-4bfd-ab3e-152660ec0b8a</ID>
      <AgreementDate>2025-01-18T05:21:49.1835947+00:00</AgreementDate>
      <AccountID>f4968e88-1d09-4749-97a1-9574771b5d74</AccountID>
      <AdminUser>true</AdminUser>
      <DateCreated>2025-01-18T05:21:49.1835947+00:00</DateCreated>
      <DateModified>2025-01-18T05:21:49.1835947+00:00</DateModified>
      <DeclineDate>2025-01-18T05:21:49.1835947+00:00</DeclineDate>
      <DisplayName>sample string 6</DisplayName>
      <DPAVersion>sample string 7</DPAVersion>
      <EmailAddress>sample string 8</EmailAddress>
      <Enabled>true</Enabled>
      <LanguageID>5b5e0766-cbeb-4f19-90d5-4c9b4b784639</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>
      <TimeZone>sample string 16</TimeZone>
      <Username>sample string 17</Username>
    </Detail>
  </ResponseData>
</ResponseOfUser>