CIService

ListArtifacts

Returns CI artifact metadata for one run, optionally narrowed to a workflow, job, or attempt. Download URLs are not included; request one per artifact with GetArtifactDownloadURL.

post/depot.ci.v1.CIService/ListArtifacts

Request

Base URL
https://api.depot.dev
Auth
HTTP bearer

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

runIdstring required

Unique identifier for the CI run. Returned by Run, DispatchWorkflow, and ListRuns.

workflowIdstring nullable

Narrows the list to artifacts from one workflow. Must belong to the run. Leave unset to include all workflows.

jobIdstring nullable

Narrows the list to artifacts from one job. Must belong to the run, and to workflowId when both are set. Leave unset to include all jobs.

attemptIdstring nullable

Narrows the list to artifacts from one job attempt. Must belong to the run, and to workflowId and jobId when set. Leave unset to include all attempts.

pageSizeinteger

Number of artifacts to return per page. Maximum: 500. Default: 100.

pageTokenstring

Token to fetch the next page of artifacts. Use the nextPageToken value from a prior response with the same filters. Leave empty to fetch the first page.

Response

Success

nextPageTokenstring nullable

Token to retrieve the next page of results. Unset when no more pages are available.

Changes

No recorded changes to this operation across all 1 revision of this API.