Method: projects.locations.builds.list

• HTTP request
• Path parameters
• Query parameters
• Request body
• Response body
• Authorization scopes
• Try it!

Lists previously requested builds.

Previously requested builds may still be in-progress, or may have finished successfully or unsuccessfully.

HTTP request

GET https://cloudbuild.googleapis.com/v1/{parent=projects/*/locations/*}/builds

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent	string The parent of the collection of Builds. Format: projects/{project}/locations/{location}

Query parameters

Parameters
projectId	string Required. ID of the project. Authorization requires the following IAM permission on the specified resource projectId: cloudbuild.builds.list
pageSize	integer Number of results to return in the list.
pageToken	string The page token for the next page of Builds. If unspecified, the first page of results is returned. If the token is rejected for any reason, INVALID_ARGUMENT will be thrown. In this case, the token should be discarded, and pagination should be restarted from the first page of results. See https://google.aip.dev/158 for more.
filter	string The raw filter text to constrain the results.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of ListBuildsResponse.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.