The updateteam.do call updates or changes the member information of the specified team.
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
Name | Type | Description |
---|---|---|
team_id Required |
Integer | Team ID. |
members | String | Comma-separated list of team member names. Provide the complete revised list to replace the current list. |
team_name | String | To change the team name, provide a new name. |
HTTPie Example
Examples use the HTTPie command-line tool. See Using HTTPie with the Python Authentication Library.
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="aswallowtail@example.com,lpieris@example.com,sviceroy@example.com,tmonarch@example.com,wbuckeye@example.com" "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. See the teaminfo.xsd schema documentation.
<?xml version="1.0" encoding="UTF-8"?> <teaminfo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="https://analysiscenter.veracode.com/schema/teaminfo/3.0" xsi:schemaLocation="https://analysiscenter.veracode.com/schema/teaminfo/3.0 https://analysiscenter.veracode.com/resource/3.0/teaminfo.xsd" teaminfo_version="3.1" account_id="<account id>" team_id="144659" team_name="Demo Team" creation_date="08/13/2019"> <users usernames="lpieris@example.com,wbuckeye@example.com,tmonarch@example.com"/> </teaminfo>