Shape the future of software delivery and make your voice heard by taking the 2021 State of DevOps survey.

Method: projects.builds.list

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/projects/{projectId}/builds

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
projectId

string

Required. ID of the project.

Query parameters

Parameters
parent

string

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

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.