/
UpdateUser (v2)

UpdateUser (v2)

Overview

Updates a user.

The function is available as a Web Service request.

Request

Parameters of the API request:

 

ParameterType

Description

Requirements
tokenStringAPI authentication tokenMandatory
userUser Specifies the updated groupMandatory

Response

Parameters of the API response:

ParameterType

Description

returnStatus

Possible return values:

    • OK
    • ERROR_GENERAL
    • ERROR_ILLEGAL_ARGUMENT
    • ERROR_UNAUTHORIZED
userUser 

Examples

 

 Example UpdateUser transaction.
Example UpdateUser transaction.
Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v2="http://v2.provisioning.ws.web.verba.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <v2:updateUser>
        <token>2Q14vHt8txwHZZeVGuZuMVuP6Czgq0cX</token>
         <user>
            <agentId></agentId>
            <externalId></externalId>
            <crmUserId></crmUserId>
 
            <customDateFormat></customDateFormat>
            <customTimeFormat></customTimeFormat>
 
            <loginName>verbatestUpdate</loginName>
            <needChangePassword>0</needChangePassword>
            <displayName>Verba Test User</displayName>
            <email>verbatestUpdate@verbalabs.com</email>
            <userType>user_type_verba</userType> <!-- Standard user type -->
 
            <eid>0000</eid>
            <!-- Needed if eid is not present
            <environmentShortName></environmentShortName>
            -->
             
            <!--Zero or more repetitions:-->
            <extensions>
               <eid>0000</eid>
               <!-- Needed if eid is not present
               <environmentShortName></environmentShortName>
               -->
 
               <extension>+12444</extension>
 
               <recordingMode>FULL</recordingMode>
               <im>1</im>
               <voice>1</voice>
               <video>0</video>
               <screenCaptureEnabled>0</screenCaptureEnabled>
            </extensions>
            <extensions>
               <eid>0000</eid>
               <!-- Needed if eid is not present
               <environmentShortName></environmentShortName>
               -->
               <extension>12444</extension>
 
               <recordingMode>FULL</recordingMode>
               <im>1</im>
               <voice>1</voice>
               <video>0</video>
               <screenCaptureEnabled>0</screenCaptureEnabled>
            </extensions>
            <extensions>
               <eid>0000</eid>
               <!-- Needed if eid is not present
               <environmentShortName></environmentShortName>
               -->
 
               <extension>verbatestUpdate@verbalabs.com</extension>
 
               <recordingMode>FULL</recordingMode>
               <im>1</im>
               <voice>1</voice>
               <video>0</video>
               <screenCaptureEnabled>0</screenCaptureEnabled>
            </extensions>
             
            <!--Zero or more repetitions:-->
            <groupMemberships>
               <member>1</member>
               <primary>1</primary>
               <supervisor>1</supervisor>
               <admin>1</admin>
               <group>
                  <eid>0000</eid>
                  <!-- <environmentShortName>?</environmentShortName>-->
                  <id>2</id>
               </group>
               <uniqueIdUnmodifiable>0</uniqueIdUnmodifiable>
               <validFromUnmodifiable>0</validFromUnmodifiable>
               <validUntilUnmodifiable>0</validUntilUnmodifiable>
            </groupMemberships>
             
            <language>en</language>
            <timeZone>Europe/Budapest</timeZone>
            <locked>0</locked>
            <nonModifiable>0</nonModifiable>
            <observerGroupId></observerGroupId>
            <observerUserId></observerUserId>
            <passwordExpires>0</passwordExpires>
            <passwordHash>MD5HASH("your-password")</passwordHash>
            <!-- <recorderLinePIN></recorderLinePIN> -->
             
            <apiAccessOnly>0</apiAccessOnly>
             
            <validFrom>2015-09-03T11:56:00Z</validFrom>
            <validTo>2099-12-31T00:00:00Z</validTo>
             
            <!--Zero or more repetitions:-->
            <roles>r_standard_user</roles>
            <roles>r_system_supervisor</roles>
            <roles>r_system_administrator</roles>
 
         </user>
      </v2:updateUser>
   </soapenv:Body>
</soapenv:Envelope>

Response:

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:updateUserResponse xmlns:ns2="http://v2.provisioning.ws.web.verba.com/">
         <return>
            <status>
               <statusCode>OK</statusCode>
            </status>
            <user>
               <agentId/>
               <apiAccessOnly>false</apiAccessOnly>
               <customDateFormat/>
               <customTimeFormat/>
               <displayName>Verba Test User</displayName>
               <eid>0000</eid>
               <email>verbatestUpdate@verbalabs.com</email>
               <environmentShortName>Ref.</environmentShortName>
               <extensions>
                  <eid>0000</eid>
                  <environmentShortName>Ref.</environmentShortName>
                  <extension>verbatestUpdate@verbalabs.com</extension>
                  <id>61</id>
                  <im>true</im>
                  <recordingMode>FULL</recordingMode>
                  <screenCaptureEnabled>false</screenCaptureEnabled>
                  <video>false</video>
                  <voice>true</voice>
               </extensions>
               <externalId/>
               <groupMemberships>
                  <admin>true</admin>
                  <group>
                     <eid>0000</eid>
                     <environmentShortName>Ref.</environmentShortName>
                     <id>2</id>
                     <name>New group name</name>
                     <nonModifiable>false</nonModifiable>
                  </group>
                  <member>true</member>
                  <primary>true</primary>
                  <supervisor>true</supervisor>
                  <uniqueIdUnmodifiable>56</uniqueIdUnmodifiable>
                  <user>
                     <agentId/>
                     <apiAccessOnly>false</apiAccessOnly>
                     <customDateFormat/>
                     <customTimeFormat/>
                     <displayName>Verba Test User</displayName>
                     <eid>0000</eid>
                     <email>verbatestUpdate@verbalabs.com</email>
                     <environmentShortName>Ref.</environmentShortName>
                     <externalId/>
                     <id>40</id>
                     <language>en</language>
                     <locked>false</locked>
                     <loginName>verbatestUpdate</loginName>
                     <needChangePassword>false</needChangePassword>
                     <nonModifiable>false</nonModifiable>
                     <observerGroupId>0</observerGroupId>
                     <observerUserId>0</observerUserId>
                     <passwordExpires>false</passwordExpires>
                     <passwordHash>....................</passwordHash>
                     <timeZone>Europe/Budapest</timeZone>
                     <userType>user_type_verba</userType>
                     <validFrom>2015-09-03T11:56:00Z</validFrom>
                     <validTo>2099-12-31T00:00:00Z</validTo>
                  </user>
                  <validFromUnmodifiable>2015-11-30T01:26:50.460Z</validFromUnmodifiable>
                  <validUntilUnmodifiable>2099-12-31T00:00:00Z</validUntilUnmodifiable>
               </groupMemberships>
               <id>40</id>
               <language>en</language>
               <locked>false</locked>
               <loginName>verbatestUpdate</loginName>
               <needChangePassword>false</needChangePassword>
               <nonModifiable>false</nonModifiable>
               <observerGroupId>0</observerGroupId>
               <observerUserId>0</observerUserId>
               <passwordExpires>false</passwordExpires>
               <roles>r_standard_user</roles>
               <roles>r_system_administrator</roles>
               <roles>r_system_supervisor</roles>
               <timeZone>Europe/Budapest</timeZone>
               <userType>user_type_verba</userType>
               <validFrom>2015-09-03T11:56:00Z</validFrom>
               <validTo>2099-12-31T00:00:00Z</validTo>
            </user>
         </return>
      </ns2:updateUserResponse>
   </S:Body>
</S:Envelope>

 

 

Related content

UpdateUser (v3)
More like this
UpdateGroup (v3)
UpdateGroup (v3)
More like this
UpdateGroup (v2)
UpdateGroup (v2)
More like this
CreateUser (v3)
More like this
DeleteUser (v2)
More like this
DeleteUser (v3)
More like this