List project builds

client.Builds.List(ctx, query) (*Page[Build], error)

get/v0/builds

List user-triggered builds for a given project.

An optional revision can be specified to filter by config commit SHA, or hashes of file contents.

ParametersExpand Collapse

query BuildListParams

Project param.Field[string]optional

Project name

Branch param.Field[string]optional

Branch name

Cursor param.Field[string]optional

Pagination cursor from a previous response.

Limit param.Field[float64]optional

Maximum number of builds to return, defaults to 10 (maximum: 100).

exclusiveMinimum0

maximum100

Revision param.Field[BuildListParamsRevisionUnion]optional

A config commit SHA used for the build

string

type BuildListParamsRevisionMap map[string, BuildListParamsRevisionMapItem]

Hash of the files used for the build

Hash string

File content hash

ReturnsExpand Collapse

type Build struct{…}

ID string

Build ID

ConfigCommit string

CreatedAt Time

DocumentedSpec BuildDocumentedSpecUnion

Accepts one of the following:

type BuildDocumentedSpecObject struct{…}

Content string

Type string

Accepts one of the following:

const BuildDocumentedSpecObjectTypeContent BuildDocumentedSpecObjectType = "content"

type BuildDocumentedSpecObject struct{…}

Expires Time

Type string

Accepts one of the following:

const BuildDocumentedSpecObjectTypeURL BuildDocumentedSpecObjectType = "url"

URL string

Object BuildObject

Accepts one of the following:

const BuildObjectBuild BuildObject = "build"

Org string

Project string

Targets BuildTargets

Cli BuildTargetoptional

Commit BuildTargetCommitUnion

Accepts one of the following:

type BuildTargetCommitNotStarted struct{…}

Status NotStarted

Accepts one of the following:

const NotStartedNotStarted NotStarted = "not_started"

type BuildTargetCommitQueued struct{…}

Status Queued

Accepts one of the following:

const QueuedQueued Queued = "queued"

type BuildTargetCommitInProgress struct{…}

Status InProgress

Accepts one of the following:

const InProgressInProgress InProgress = "in_progress"

type BuildTargetCommitCompleted struct{…}

Completed BuildTargetCommitCompletedCompleted

Commit Commit

Repo CommitRepo

Branch string

Name string

Owner string

Sha string

Conclusion string

Accepts one of the following:

const BuildTargetCommitCompletedCompletedConclusionError BuildTargetCommitCompletedCompletedConclusion = "error"

const BuildTargetCommitCompletedCompletedConclusionWarning BuildTargetCommitCompletedCompletedConclusion = "warning"

const BuildTargetCommitCompletedCompletedConclusionNote BuildTargetCommitCompletedCompletedConclusion = "note"

const BuildTargetCommitCompletedCompletedConclusionSuccess BuildTargetCommitCompletedCompletedConclusion = "success"

const BuildTargetCommitCompletedCompletedConclusionMergeConflict BuildTargetCommitCompletedCompletedConclusion = "merge_conflict"

const BuildTargetCommitCompletedCompletedConclusionUpstreamMergeConflict BuildTargetCommitCompletedCompletedConclusion = "upstream_merge_conflict"

const BuildTargetCommitCompletedCompletedConclusionFatal BuildTargetCommitCompletedCompletedConclusion = "fatal"

const BuildTargetCommitCompletedCompletedConclusionPaymentRequired BuildTargetCommitCompletedCompletedConclusion = "payment_required"

const BuildTargetCommitCompletedCompletedConclusionCancelled BuildTargetCommitCompletedCompletedConclusion = "cancelled"

const BuildTargetCommitCompletedCompletedConclusionTimedOut BuildTargetCommitCompletedCompletedConclusion = "timed_out"

const BuildTargetCommitCompletedCompletedConclusionNoop BuildTargetCommitCompletedCompletedConclusion = "noop"

const BuildTargetCommitCompletedCompletedConclusionVersionBump BuildTargetCommitCompletedCompletedConclusion = "version_bump"

MergeConflictPr BuildTargetCommitCompletedCompletedMergeConflictPr

Number float64

Repo BuildTargetCommitCompletedCompletedMergeConflictPrRepo

Name string

Owner string

Status Completed

Accepts one of the following:

const CompletedCompleted Completed = "completed"

InstallURL string

Lint CheckStepUnion

Accepts one of the following:

type CheckStepNotStarted struct{…}

Status NotStarted

Accepts one of the following:

const NotStartedNotStarted NotStarted = "not_started"

type CheckStepQueued struct{…}

Status Queued

Accepts one of the following:

const QueuedQueued Queued = "queued"

type CheckStepInProgress struct{…}

Status InProgress

Accepts one of the following:

const InProgressInProgress InProgress = "in_progress"

type CheckStepCompleted struct{…}

Completed CheckStepCompletedCompleted

Conclusion string

Accepts one of the following:

const CheckStepCompletedCompletedConclusionSuccess CheckStepCompletedCompletedConclusion = "success"

const CheckStepCompletedCompletedConclusionFailure CheckStepCompletedCompletedConclusion = "failure"

const CheckStepCompletedCompletedConclusionSkipped CheckStepCompletedCompletedConclusion = "skipped"

const CheckStepCompletedCompletedConclusionCancelled CheckStepCompletedCompletedConclusion = "cancelled"

const CheckStepCompletedCompletedConclusionActionRequired CheckStepCompletedCompletedConclusion = "action_required"

const CheckStepCompletedCompletedConclusionNeutral CheckStepCompletedCompletedConclusion = "neutral"

const CheckStepCompletedCompletedConclusionTimedOut CheckStepCompletedCompletedConclusion = "timed_out"

URL string

Status Completed

Accepts one of the following:

const CompletedCompleted Completed = "completed"

Object BuildTargetObject

Accepts one of the following:

const BuildTargetObjectBuildTarget BuildTargetObject = "build_target"

Status BuildTargetStatus

Accepts one of the following:

const BuildTargetStatusNotStarted BuildTargetStatus = "not_started"

const BuildTargetStatusCodegen BuildTargetStatus = "codegen"

const BuildTargetStatusPostgen BuildTargetStatus = "postgen"

const BuildTargetStatusCompleted BuildTargetStatus = "completed"

Test CheckStepUnion

Accepts one of the following:

type CheckStepNotStarted struct{…}

Status NotStarted

Accepts one of the following:

const NotStartedNotStarted NotStarted = "not_started"

type CheckStepQueued struct{…}

Status Queued

Accepts one of the following:

const QueuedQueued Queued = "queued"

type CheckStepInProgress struct{…}

Status InProgress

Accepts one of the following:

const InProgressInProgress InProgress = "in_progress"

type CheckStepCompleted struct{…}

Completed CheckStepCompletedCompleted

Conclusion string

Accepts one of the following:

const CheckStepCompletedCompletedConclusionSuccess CheckStepCompletedCompletedConclusion = "success"

const CheckStepCompletedCompletedConclusionFailure CheckStepCompletedCompletedConclusion = "failure"

const CheckStepCompletedCompletedConclusionSkipped CheckStepCompletedCompletedConclusion = "skipped"

const CheckStepCompletedCompletedConclusionCancelled CheckStepCompletedCompletedConclusion = "cancelled"

const CheckStepCompletedCompletedConclusionActionRequired CheckStepCompletedCompletedConclusion = "action_required"

const CheckStepCompletedCompletedConclusionNeutral CheckStepCompletedCompletedConclusion = "neutral"

const CheckStepCompletedCompletedConclusionTimedOut CheckStepCompletedCompletedConclusion = "timed_out"

URL string

Status Completed

Accepts one of the following:

const CompletedCompleted Completed = "completed"

Build CheckStepUnionoptional

Accepts one of the following:

type CheckStepNotStarted struct{…}

Status NotStarted

Accepts one of the following:

const NotStartedNotStarted NotStarted = "not_started"

type CheckStepQueued struct{…}

Status Queued

Accepts one of the following:

const QueuedQueued Queued = "queued"

type CheckStepInProgress struct{…}

Status InProgress

Accepts one of the following:

const InProgressInProgress InProgress = "in_progress"

type CheckStepCompleted struct{…}

Completed CheckStepCompletedCompleted

Conclusion string

Accepts one of the following:

const CheckStepCompletedCompletedConclusionSuccess CheckStepCompletedCompletedConclusion = "success"

const CheckStepCompletedCompletedConclusionFailure CheckStepCompletedCompletedConclusion = "failure"

const CheckStepCompletedCompletedConclusionSkipped CheckStepCompletedCompletedConclusion = "skipped"

const CheckStepCompletedCompletedConclusionCancelled CheckStepCompletedCompletedConclusion = "cancelled"

const CheckStepCompletedCompletedConclusionActionRequired CheckStepCompletedCompletedConclusion = "action_required"

const CheckStepCompletedCompletedConclusionNeutral CheckStepCompletedCompletedConclusion = "neutral"

const CheckStepCompletedCompletedConclusionTimedOut CheckStepCompletedCompletedConclusion = "timed_out"

URL string

Status Completed

Accepts one of the following:

const CompletedCompleted Completed = "completed"

Csharp BuildTargetoptional