Send feedback
Method: projects.builds.approve
Stay organized with collections
Save and categorize content based on your preferences.
Approves or rejects a pending build.
If approved, the returned long-running operation (LRO) will be analogous to the LRO returned from a builds.create call.
If rejected, the returned LRO will be immediately done.
HTTP request
Choose a location:
global africa-south1 asia-east1 asia-east2 asia-northeast1 asia-northeast2 asia-northeast3 asia-south1 asia-south2 asia-southeast1 asia-southeast2 asia-southeast3 australia-southeast1 australia-southeast2 europe-central2 europe-north1 europe-north2 europe-southwest1 europe-west1 europe-west10 europe-west12 europe-west2 europe-west3 europe-west4 europe-west6 europe-west8 europe-west9 europe-west15 me-central1 me-central2 me-west1 northamerica-northeast1 northamerica-northeast2 northamerica-south1 southamerica-east1 southamerica-west1 us-central1 us-central2 us-east1 us-east4 us-east5 us-east7 us-south1 us-west1 us-west2 us-west3 us-west4 us-west8
POST https://cloudbuild.googleapis.com/v1/{name=projects/*/builds/*}:approve
The URLs use gRPC Transcoding syntax.
Path parameters
Parameters
name
string
Required. Name of the target build. For example: "projects/{$projectId}/builds/{$buildId}"
Authorization requires the following IAM permission on the specified resource name:
cloudbuild.builds.approve
Request body
The request body contains data with the following structure:
Fields
approvalResult
object (ApprovalResult )
Approval decision and metadata.
Response body
If successful, the response body contains an instance of Operation .
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview .
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-06-09 UTC.
Need to tell us more?
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-06-09 UTC."],[],[]]