createteam.do

Veracode APIs

The createteam.do call creates a new team of users.

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

REST API Equivalent

The REST API equivalent of this call is a POST to /api/authn/v2/teams 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/createteam.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
team_name

Required

String Must be unique.
members String Comma-separated list of usernames.

HTTPie Example

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

http --auth-type=veracode_hmac -o newteaminfo.xml "https://analysiscenter.veracode.com/api/3.0/createteam.do" "team_name==Release Team" "[email protected],[email protected]"

HTTPie Results

The createteam.do call returns the teaminfo XML document, which shows a user list filtered by the new team name, listing the users in the team. This XML document references the teaminfo.xsd schema file. You can use the XSD schema file to validate the XML data.
<?xml version="1.0" encoding="UTF-8"?>

<teaminfo 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;teaminfo&#x2f;3.0" 
      xsi:schemaLocation="https&#x3a;&#x2f;&#x2f;analysiscenter.veracode.com&#x2f;schema&#x2f;teaminfo&#x2f;3.0 
      https&#x3a;&#x2f;&#x2f;analysiscenter.veracode.com&#x2f;resource&#x2f;3.0&#x2f;teaminfo.xsd" teaminfo_version="3.1" 
      account_id="<account id>" team_id="<team id>" team_name="Release Team" creation_date="09&#x2f;06&#x2f;2019">
   <users usernames="bmetalmark&#x40;example.com,tmonarch&#x40;example.com"/>
</teaminfo>