# Target Runs

APIs to manage Target Runs. Target run status descriptions
  * PENDING - Target run created.
  * QUEUED - Target run queued for processing.
  * PROCESSING - Target run received by scheduler for processing (During target run processing the command request for the target run is created).
  * DISPATCHED - Target run moves to dispatched when a command is successfully queued for the target run. (Command status - QUEUED)
  * RUNNING - Target run moves to running state when the command has been sent to the device (Command status - INITIATED, ACKNOWLEDGED, INPROGRESS)
  * COMPLETE - Target run moves to complete state when it has completed running (Command status - FAILURE, SUCCESS, TIMEOUT, CANCELLED)
  * SUCCESS - A completed target run moves to success when the associated command is successful (Command status - SUCCESS)
  * FAILURE - A completed target run moves to success when the associated command is unsuccessful (Command status - FAILED, TIMEOUT, CANCELLED)
  * CANCELLED - Target run cancelled by the user (Target runs ind Pending, Queued and Processing state can be cancelled by the user)
  * TIMEOUT -  The target run has a timed out. This happens when the target run has not completed processing even after the timeout period (7 days).
  * INVALID - Target run is invalid.


## Get all Target Runs for the Stage Run

 - [GET /pipelines/v0/stageruns/{stage_run_id}/targetruns/](https://develop-api.esper.io/openapi/target-runs/getpipelinestagetargetruns.md)

## Create a Target Runs for Stage Run

 - [POST /pipelines/v0/stageruns/{stage_run_id}/targetruns/](https://develop-api.esper.io/openapi/target-runs/createpipelinestagetargetruns.md)

## Get Target Run by Target Run ID

 - [GET /pipelines/v0/stageruns/{stage_run_id}/targetruns/{target_run_id}/](https://develop-api.esper.io/openapi/target-runs/getpipelinestagetargetrun.md)

## Update a Target Run

 - [PUT /pipelines/v0/stageruns/{stage_run_id}/targetruns/{target_run_id}/](https://develop-api.esper.io/openapi/target-runs/updatepipelinestagetargetrun.md)

## Get status of the command running for Target run

 - [GET /pipelines/v0/stageruns/{stage_run_id}/targetruns/{target_run_id}/command/](https://develop-api.esper.io/openapi/target-runs/gettargetruncommandstatus.md)

## Create an command processor request for Target Run

 - [POST /pipelines/v0/stageruns/{stage_run_id}/targetruns/{target_run_id}/command/](https://develop-api.esper.io/openapi/target-runs/createtargetruncommand.md)

## Update target run command information.

 - [PUT /pipelines/v0/stageruns/{stage_run_id}/targetruns/{target_run_id}/command/{command_id}/](https://develop-api.esper.io/openapi/target-runs/puttargetruncommandstatus.md)