Pipeline Runs

Get a pipeline run

Changed on

Retrieve a single pipeline run by ID, including its status, however long ago it ran.

get/pipeline_runs/{pipeline_run_id}

Request

  • Base URL
    https://app.getorchestra.io/api/engine/public
  • URL
    https://app.getorchestra.io/api/engine/public/pipeline_runs/{pipeline_run_id}
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://app.getorchestra.io/oauth/authorize
      Token URL: https://app.getorchestra.io/oauth/token scopes: orchestra:read

Path parameters

pipeline_run_idstring uuid4 required

Pipeline run ID.

Headers

X-Orchestra-Account-Idstring uuid4 nullable

Act on this account rather than the one the credential resolves to. Omit it to use the credential's own account. An API key is issued to a single account, so it may only name that account; an OAuth token may name any account its grant covers.

Response

Successful Response

idstring uuid4 required
pipelineIdstring uuid4 required
pipelineNamestring required
accountIdstring uuid4 required
envIdstring uuid4 nullable
envNamestring nullable
runStatus'QUEUED' | 'CREATED' | 'RUNNING' | 'SUCCEEDED' | 'WARNING' | 'FAILED' | 'SKIPPED' | 'CANCELLING' | 'CANCELLED' required
hasAnomaliesboolean nullable
anomaliesobject nullable
messagestring required
pipelineVersionNumberinteger nullable
createdAtstring required
updatedAtstring required
completedAtstring nullable
startedAtstring nullable
branchstring nullable
commitstring nullable
gitLinkstring nullable

Changes

    • warning

      added the new LIGHTDASH_CLEAR_RESULTS_CACHE enum value to the /////// response property for the response status

    • warning

      added the new LIGHTDASH_CLEAR_RESULTS_CACHE enum value to the ///// response property for the response status

    • info

      endpoint added