Method: projects.locations.builds.approve

Stay organized with collections Save and categorize content based on your preferences.

Approves or rejects a pending build.

If approved, the returned LRO will be analogous to the LRO returned from a builds.create call.

If rejected, the returned LRO will be immediately done.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. Name of the target build. For example: "projects/{$projectId}/builds/{$build_id}"

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:

JSON representation
  "approvalResult": {
    object (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:


For more information, see the Authentication Overview.