Skip to main content

updateteam.do (Deprecated)

The updateteam.do call updates or changes the member information of the specified team.

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 PUT to /api/authn/v2/teams/{teamId} 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/updateteam.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

NameTypeDescription
team_id
Required
IntegerTeam ID.
membersStringComma-separated list of team member names. Provide the complete revised list to replace the current list.
team_nameStringTo change the team name, provide a new name.

HTTPie example

Examples use the HTTPie command-line tool.

To get the current membership of the team before you change it, call getuserlist.do.

http --auth-type=veracode_hmac "https://analysiscenter.veracode.com/api/3.0/getuserlist.do" "teams==<teamid>"

This example updates the members of the team.

http --auth-type=veracode_hmac -o `updatedteaminfo.xml` "https://analysiscenter.veracode.com/api/3.0/updateteam.do" "members="[email protected],[email protected],[email protected],[email protected],[email protected]" "team_id==144659"

HTTPie results

The updateteam.do call returns the teaminfo XML document, which 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="144659" team_name="Demo Team" creation_date="08&#x2f;13&#x2f;2019">
<users usernames="lpieris&#x40;example.com,wbuckeye&#x40;example.com,tmonarch&#x40;example.com"/>
</teaminfo>