Authorization requires the following IAM permission on the specified resource projectId:
cloudbuild.builds.list
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.
[[["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 2025-07-17 UTC."],[[["\u003cp\u003eThis API endpoint retrieves a list of previously requested builds for a specified project.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request uses a \u003ccode\u003eGET\u003c/code\u003e method and requires the project ID as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eQuery parameters, including \u003ccode\u003eparent\u003c/code\u003e, \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, and \u003ccode\u003efilter\u003c/code\u003e, can be used to refine the list of builds retrieved.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and successful requests return a \u003ccode\u003eListBuildsResponse\u003c/code\u003e instance.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this endpoint requires the \u003ccode\u003ecloudbuild.builds.list\u003c/code\u003e IAM permission and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,[]]
