promotesandbox.do

APIs

The promotesandbox.do call promotes a sandbox scan to a policy scan for the specified build ID.

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

Resource URL

https://analysiscenter.veracode.com/api/5.0/promotesandbox.do

Parameters

build_id Integer. Required.

You can identify your build_id by calling getbuildlist.do.

Example

curl -k -u <VeracodeUsername>:<VeracodePassword>
          https://analysiscenter.veracode.com/api/5.0/promotesandbox.do -F
        "build_id=10391"

Results

The promotesandbox.do call returns the sandboxinfo XML document, which references the sandboxinfo.xsd. Additional sandboxinfo.xsd schema documentation is available. Use the XSD file to validate the XML data. The following is an example of the returned XML.
<?xml version="1.0" encoding="UTF-8"?>
<sandboxinfo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="https://analysiscenter.veracode.com/schema/5.0/sandboxinfo" xsi:schemaLocation="https://analysiscenter.veracode.com/schema/5.0/sandboxinfo https://analysiscenter.veracode.com//resource/5.0/sandboxinfo.xsd" sandboxinfo_version="1.1" account_id="10023" app_id="10255" build_id="10391" analysis_id="10388" analysis_unit_id="10388">
<sandbox sandbox_id="10270" sandbox_name="Dev_Sandbox" sandbox_status="policy" owner="ds_user" modified_date="2014-09-26T02:06:55-04:00" created_date="2014-09-26T01:49:46-04:00"/>
</sandboxinfo>