updateuser.do

APIs

The updateuser.do call updates or changes the information of the specified user account.

Before using this API, Veracode strongly recommends that you read API Usage and Access Guidelines.

Resource URL

https://analysiscenter.veracode.com/api/3.0/updateuser.do

Permissions

Non-human user accounts require the Admin API role to use this call. Human user accounts require the Administrator role to use this call.

Parameters

username String. Required.
custom_id String. Required for SAML users. The custom_id field is an identifier to inform the system which user it is updating.

The following are optional parameters. Use updateuser.do to change any of the parameters that you can change in the Veracode Platform, except for login_account_type. The getuserlist.do call also uses these parameters.

To change the username, send a new value in the email_address parameter.

If your call incorrectly sets is_saml_user to true, you receive an error. The login account must have SAML enabled and have a custom_id. If the account does have SAML enabled but lacks a custom_id, you can set is_saml_user to true and provide the missing custom_id.

You cannot set is_saml_user to false, because SAML users cannot be converted to non-SAML users.

If you want to change the custom_id, use the new_custom_id parameter with the new ID.

first_name String.
last_name String.
email_address Valid email address.
phone String.
teams Case-sensitive comma-delimited string.
roles Case-sensitive comma-delimited string. You can only pass the following human user roles: Administrator, Creator, Executive, Greenlight IDE User, Mitigation Approver, Policy Administrator, Reviewer, Security Lead, Submitter, Security Insights, eLearning, Vendor Manager, Delete Scans, Sandbox Administrator, or Sandbox User. You cannot pass any of the non-human API user roles. If you use either the Creator, Security Lead, or Submitter role, Veracode automatically applies the Any Scan scan permission to the scans.

You can apply scan permissions to these types of scans: Static Analysis, DynamicDS, DynamicMP, Discovery, manual, and Dynamic Analysis.

new_custom_id String. For SAML users to change the identifier of the user account.
has_ip_restrictions Boolean.
allowed_ip_addresses String. A list of whitelisted IP address from which you can log in. You can only update this list if has_ip_restrictions is true.
is_saml_user Boolean. You can only update this parameter if your account is SAML-enabled.
login_enabled Boolean.
requires_token Boolean.
is_elearning_manager Boolean. You can only update this parameter if your account has an active Veracode eLearning subscription.
elearning_manager String. The first and last name, not the username of the Veracode eLearning manager. For example, Mary Doe. You can only update this parameter if your account has an active Veracode eLearning subscription.
elearning_track String. The Veracode eLearning track name. You can only update this parameter if your account has an active eLearning subscription.
elearning_curriculum String. The Veracode eLearning curriculum name. You can only update this parameter if your account has an active eLearning subscription.
keep_elearning_active Boolean. You can only update this parameter if your account has an active eLearning subscription.
custom_one String. Custom field.
custom_two String. Custom field.
custom_three String. Custom field.
custom_four String. Custom field.
custom_five String. Custom field.

HTTPie Example

http --auth-type=veracode_hmac -o updateduserinfo.xml "https://analysiscenter.veracode.com/api/3.0/updateuser.do" "username==tmonarch@example.com" "phone==111-222-3333"

HTTPie Results

The updateuser.do call returns the output XML document, which references the userinfo.xsd. Additional userinfo.xsd schema documentation is available. Use the XSD file to validate the XML data.
<?xml version="1.0" encoding="UTF-8"?>

<userinfo xmlns:xsi="http&#x3a;&#x2f;&#x2f;www.w3.org&#x2f;2001&#x2f;XMLSchema-instance" 
      xmlns="https&#x3a;&#x2f;&#x2f;analysiscenter.veracode.com&#x2f;schema&#x2f;userinfo&#x2f;3.0" 
      xsi:schemaLocation="https&#x3a;&#x2f;&#x2f;analysiscenter.veracode.com&#x2f;schema&#x2f;userinfo&#x2f;3.0 
      https&#x3a;&#x2f;&#x2f;analysiscenter.veracode.com&#x2f;resource&#x2f;3.0&#x2f;userinfo.xsd" userinfo_version="3.0" 
      username="tmonarch&#x40;example.com">
   <login_account first_name="Ted" last_name="Monarch" login_account_type="user" email_address="tmonarch&#x40;example.com" 
      phone="111-222-3333" login_enabled="true" requires_token="false" teams="Demo Team" 
      roles="Creator,eLearning,Submitter,Any Scan" is_elearning_manager="false" elearning_manager="No Manager" 
      elearning_track="No Track Assigned" elearning_curriculum="No Curriculum Assigned" keep_elearning_active="false"/>
</userinfo>