# Stage Runs

APIs to manage Stage Runs. Stage run status descriptions
  * PENDING - Stage run created.
  * QUEUED - Stage run queued for processing.
  * PROCESSING - Stage run received by scheduler for processing.(Processing a stage run can involve performing the operations required before starting a stage run. In this case creating the target runs for the stage.)
  * RUNNING - Stage run has started running.  
  * COMPLETE - Stage run moves to complete if all target runs are complete (target runs are complete if they are in a terminal state).
  * SUCCESS - A completed stage run moves to success if all target runs are successful. 
  * FAILURE - A completed stage moves to failure if all target runs are not successful.
  * CANCELLED - Stage run cancelled by user.
  * TIMEOUT - The stage run has a timed out. This happens when the stage run has not completed processing even after the timeout period (Default 7 days).
  * INVALID -  A stage run moves to invalid state when 
                a. The associated stage has no targets.
                b. The associated stage has no operations.


## Get all Stage Runs for the Pipeline Run

 - [GET /pipelines/v0/runs/{pipeline_run_id}/stageruns/](https://develop-api.esper.io/openapi/stage-runs/getpipelinerunstageruns.md)

## Get Pipeline Stage run by stage run Id

 - [GET /pipelines/v0/runs/{pipeline_run_id}/stageruns/{stage_run_id}/](https://develop-api.esper.io/openapi/stage-runs/getpipelinerunstagerun.md)

## Update a Pipeline Stage Run

 - [PUT /pipelines/v0/runs/{pipeline_run_id}/stageruns/{stage_run_id}/](https://develop-api.esper.io/openapi/stage-runs/updatepipelinerunstagerun.md)

## Get all Operations for the Stage Run

 - [GET /pipelines/v0/stageruns/{stage_run_id}/operations/](https://develop-api.esper.io/openapi/stage-runs/getpipelinestagerunoperations.md)

## Get single Operation for the Stage Run

 - [GET /pipelines/v0/stageruns/{stage_run_id}/operations/{stage_run_operation_id}/](https://develop-api.esper.io/openapi/stage-runs/getpipelinestagerunoperation.md)