Method: updateUserProfile

Permissions to Run the Request

Account Owner, Account Administrators, Department Administrators, or custom roles.

Department Administrators and users with a custom role can edit profiles of the users belonging to the departments they manage and their sub-departments.

Request Headers

Parameter	Type	Description
token (required)	string	Access token. You can obtain a token by making a request
userId (required)	string	The ID of the user whose profile you want to update
email (optional)	string	The email of the user
password (optional)	string	The password of the user
login (required)	string	The login of the user
departmentId (required)	string	The department ID the user belongs to
role (optional)	string	If you assign one of the standard roles to the user (except for Account Owner), use one of the following values for the role parameter: account_administrators department_administrators course_authors learners supervisor Learn more about using the role parameter in the Important section
roleId (required if the custom value is used for the role parameter)	string	The roleId parameter is used, if you assign one of the custom roles to the user. In this case, you will need to use the needed role ID for the roleId parameter. Learn more about using the roleId parameter in the Important section.
manageableDepartmentIds (required if the user's role is Department Administrator or a custom role)	string[]	An array with the IDs of the departments the user will manage
groups (optional)	string[]	Array of IDs of the groups the user will be added to
roles (optional)	string[]	An array of data using which you can assign one or two roles to a user. You will need to use the needed role ID for the roleId parameter inside the array. If you assign two roles, one of them will be Learner, and the second role — one of the administrative roles (Account Administrator, Department Administrator, or a custom role). Learn more about using the roles parameter in the Important section.
about_me (optional)	string	A user's personal information in the About me field

Important:

If in the account there are required user profile fields (apart from the fields of the 'Country' format), they should be also put into the request.
The user role can be assigned in one of two ways:
1. Using the role (if the assigned role is Account Administrator, Department Administrator, or Learner) and roleId (if the role is a custom role) tags,
2. Using the roles array of data.
If you use the roles array of data to assign a user role, you will be able to select two roles at once.

One of the roles will be Learner and the second role will be one of the administrative roles (Account Administrator, Department Administrator, or a custom role).

If you add two administrative role to the roles array of data, the user won't be added.
If you have assigned a user role both with the role/roleId tags and the roles array of data, the user will be assigned to a role or roles specified in the roles array of data and the value specified in the role/roleId tags will be then ignored.
If you haven't specified the user role with the role/roleId tags or with the roles array of data, the user will be assigned to the Learner role.

Return Value

After the request has been completed, the system returns an object with the following properties:

Parameter	Type	Description
success	bool	True if the user's profile has been updated

Possible Errors

Type	Description
Unknown user	The user with the specified ID was not found
Permission denied	The user has no permissions to update info of the specified user
Wrong Parameters	One of the specified parameters is incorrect
Invalid value <field_value>. Field <field_name> must be unique.	An error occurs if the Login and Email 'user_fields' have been changed. They should be unique

Sample Call

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
                   xmlns="https://new.webservice.namespace">
  <SOAP-ENV:Body>
    <UpdateUserProfileRequest>
      <credentials>          
        <token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</token>       
      </credentials>
      <userId>string</userId>
      <fields>
        <field>
          <name>LOGIN</name>
          <value>kate.smith@ispringsolutions.com</value>
        </field>
        <field>
          <name>PASSWORD</name>
          <value>1234</value>
        </field>
        <field>
          <name>EMAIL</name>
          <value>kate.smith@ispringsolutions.com</value>
        </field>
        <field>
          <name>FIRST_NAME</name>
          <value>John</value>
        </field>
        <field>
          <name>LAST_NAME</name>
          <value>Smith</value>
        </field>
        <field>
          <name>COUNTRY</name>
          <value>1</value>
        </field>
      </fields>
      <groups>
        <id>string</id>
        <id>string</id>
      </groups>
      <role>department_administrator</role>
      <departmentId>string</departmentId>
      <manageableDepartmentIds>
        <id>string</id>
        <id>string</id>
      </manageableDepartmentIds>
      <about_me>I provide professional development for the teams and set quarterly goals based on the team's performance to date.</about_me> </request>
    </UpdateUserProfileRequest>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Sample Response

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
                   xmlns="https://new.webservice.namespace">
  <SOAP-ENV:Body>
    <UpdateUserProfileResult>
      <success>true</success>
    </UpdateUserProfileResult>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>