Skip to main content

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, Veracode strongly recommends that you read 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

NameTypeDescription
app_id
Required
IntegerApplication ID.
build_idIntegerApplication or sandbox build ID.
versionStringSpecify a unique identifier for the build.
lifecycle_stageStringValidates against the names of the Lifecycle enums.
launch_dateStringValidates against the mm/dd/yyyy date format.
sandbox_idIntegerEnter 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&#x3a;&#x2f;&#x2f;www.w3.org&#x2f;2001&#x2f;XMLSchema-instance"
xmlns="https&#x3a;&#x2f;&#x2f;analysiscenter.veracode.com&#x2f;schema&#x2f;4.0&#x2f;buildinfo"
xsi:schemaLocation="https&#x3a;&#x2f;&#x2f;analysiscenter.veracode.com&#x2f;schema&#x2f;4.0&#x2f;buildinfo
https&#x3a;&#x2f;&#x2f;analysiscenter.veracode.com&#x2f;resource&#x2f;4.0&#x2f;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&#x3a;02&#x3a;08-04&#x3a;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>