updatebuild.do
The updatebuild.do call updates the most recent build of an existing application in the portfolio. To update an earlier build, specify the build_id parameter.
Before using this API, we recommend reading API usage and access guidelines. Ensure you access the APIs with the domain for your region.
Resource URL
https://analysiscenter.veracode.com/api/5.0/updatebuild.do
Parameters
| Name | Type | Description |
|---|---|---|
app_idRequired | Integer | Application ID. |
build_id | Integer | Application or sandbox build ID. |
version | String | Specify a unique identifier for the build. |
lifecycle_stage | String | Validates against the names of the Lifecycle enums. |
launch_date | String | Validates against the mm/dd/yyyy date format. |
sandbox_id | Integer | Enter the ID of the sandbox that contains the build to update. |
HTTPie example
Examples use the HTTPie command-line tool.
http --auth-type=veracode_hmac "https://analysiscenter.veracode.com/api/5.0/updatebuild.do" "app_id==<app id>" "version==outdated1"
HTTPie results
The updatebuild.do call returns the buildinfo XML document, which references the buildinfo.xsd schema file. You can use the XSD schema file to validate the XML data.
<?xml version="1.0" encoding="UTF-8"?>
<buildinfo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="https://analysiscenter.veracode.com/schema/4.0/buildinfo"
xsi:schemaLocation="https://analysiscenter.veracode.com/schema/4.0/buildinfo
https://analysiscenter.veracode.com/resource/4.0/buildinfo.xsd" buildinfo_version="1.5"
account_id="<account id>" app_id="<app id>" build_id="<build id>">
<build version="outdated1" build_id="<build id>"
submitter="Veracode" platform="Not Specified" lifecycle_stage="Not Specified" results_ready="false"
policy_name="Veracode Transitional Very High" policy_version="1" policy_compliance_status="Not Assessed"
policy_updated_date="2019-08-13T14:02:08-04:00" rules_status="Not Assessed" grace_period_expired="false"
scan_overdue="false" legacy_scan_engine="false">
</analysis_unit analysis_type="Static" status="Scan In Process" eta_status="Under Investigation" engine_version="20190805180615"/>
</build>
</buildinfo>