deleteuser.do

Veracode APIs

The deleteuser.do call deletes a user account. To delete a API service account, you must use the Veracode Platform or the Identity REST API.

Before using this API, Veracode strongly recommends that you read API Usage and Access Guidelines. Ensure you access the APIs with the domain for your region.

REST API Equivalent

The REST API equivalent of this call is a DELETE to /api/authn/v2/users/{userId} using the Identity API. Veracode strongly recommends that you use the REST API for this action. For new integrations, always use the REST APIs.

Resource URL

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

Permissions

An API service account requires the Admin API role to use this call. A user account requires the Administrator role to use this call.

Parameters

Name Type Description
username

Required

String Required for non-SAML users. Usually the email address of the user.
custom_id

Required

String Required for SAML users. The SAML Subject field value from the user account.

HTTPie Example

Examples use the HTTPie command-line tool. See Using HTTPie with the Python Authentication Library.

http --auth-type=veracode_hmac -o deleteduserinfo.xml "https://analysiscenter.veracode.com/api/3.0/deleteuser.do" "[email protected]"

HTTPie Results

The deleteuser.do call returns the deleteuserresult XML document, which references the deleteuserresult.xsd schema file. You can use the XSD schema file to validate the XML data.

In the return, the <filters .../> element lists the deleted usernames, while the <users .../> element lists the remaining users.

<?xml version="1.0" encoding="UTF-8"?>

<deleteuserresult xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="https://analysiscenter.veracode.com/schema/deleteuserresult" 
xsi:schemaLocation="https://analysiscenter.veracode.com/schema/deleteuserresult 
https://analysiscenter.veracode.com/resource/deleteuserresult.xsd" userlist_version="3.0" username="username-99-1596061905076">
  <result>success</result>
</deleteuserresult>