# Pipeline Runs

APIs to manage Pipeline Runs. Pipeline run status descriptions
  * PENDING - Pipeline run created.
  * QUEUED - Pipeline run queued for processing.
  * PROCESSING - Pipeline run received by scheduler for processing. (Processing a pipeline involves performing the operations required before starting a pipeline)
  * RUNNING - Pipeline run has started running.
  * WAITING -  Pipeline run is waiting for an action (manual/automatic).
  * COMPLETE - The pipeline run has completed processing i.e. All stage runs are processed. A complete pipeline run can move to success or failure.
  * SUCCESS - A completed pipeline run moves to success if all stage runs are successful.
  * FAILURE - A completed pipeline run moves to failure if all stage runs are not successful.
  * CANCELLED - Pipeline run is cancelled by the user.
  * TIMEOUT -  The pipeline run has a timed out. This happens when the pipeline has not completed processing even after the timeout period (Default 21 days).
  * INVALID - A pipeline run moves to invalid state when Pipeline run has no stageruns i.e pipeline has zero stages.


## Get all Runs for the Pipelines in the Enterprise

 - [GET /pipelines/v0/runs/](https://develop-api.esper.io/openapi/pipeline-runs/getallpipelineruns.md)

## Get all Runs for the Pipeline

 - [GET /pipelines/v0/pipelines/{pipeline_id}/runs/](https://develop-api.esper.io/openapi/pipeline-runs/getpipelineruns.md)

## Create a Pipeline Run

 - [POST /pipelines/v0/pipelines/{pipeline_id}/runs/](https://develop-api.esper.io/openapi/pipeline-runs/createpipelinerun.md)

## Get Pipeline run by pipeline run id

 - [GET /pipelines/v0/pipelines/{pipeline_id}/runs/{pipeline_run_id}/](https://develop-api.esper.io/openapi/pipeline-runs/getpipelinerun.md)

## Update a Pipeline Run

 - [PUT /pipelines/v0/pipelines/{pipeline_id}/runs/{pipeline_run_id}/](https://develop-api.esper.io/openapi/pipeline-runs/updatepipelinerun.md)

## Delete a Pipeline Run

 - [DELETE /pipelines/v0/pipelines/{pipeline_id}/runs/{pipeline_run_id}/](https://develop-api.esper.io/openapi/pipeline-runs/deletepipelinerun.md)