# Esper pipelines_Stage Runs API

**Canonical:** https://apis.io/apis/esper/esper-pipelines-stage-runs-api/  
**Provider:** Esper — https://apis.io/providers/esper/  
**Base URL:** https://foo-api.esper.cloud/api  
**Documentation:** https://api.esper.io/openapi

Esper pipelines_Stage Runs API is one of 74 APIs that [Esper](https://apis.io/providers/esper/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include pipelines_Stage Runs. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.

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.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/pipelines/v0/runs/{pipeline_run_id}/stageruns/` | Get all Stage Runs for the Pipeline Run |
| GET | `/pipelines/v0/runs/{pipeline_run_id}/stageruns/{stage_run_id}/` | Get Pipeline Stage run by stage run Id |
| PUT | `/pipelines/v0/runs/{pipeline_run_id}/stageruns/{stage_run_id}/` | Update a Pipeline Stage Run |
| GET | `/pipelines/v0/stageruns/{stage_run_id}/operations/` | Get all Operations for the Stage Run |
| GET | `/pipelines/v0/stageruns/{stage_run_id}/operations/{stage_run_operation_id}/` | Get single Operation for the Stage Run |

## Machine-readable artifacts (11)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/esper/refs/heads/main/openapi/esper-pipelines-stage-runs-api-openapi.yml
- **Documentation** — https://help.esper.io/hc/en-us/categories/11385054747153-Developer-Documentation
- **APIReference** — https://api.esper.io/openapi
- **GettingStarted** — https://help.esper.io/hc/en-us/articles/14199291792145-Getting-Started-with-APIs
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/esper/refs/heads/main/authentication/esper-authentication.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/esper/refs/heads/main/errors/esper-problem-types.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/esper/refs/heads/main/conventions/esper-conventions.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/esper/refs/heads/main/data-model/esper-data-model.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/esper/refs/heads/main/conformance/esper-conformance.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/esper/refs/heads/main/lifecycle/esper-lifecycle.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/esper/refs/heads/main/asyncapi/esper-events-webhooks.yml

## Other Esper APIs (12)

- [Esper apps_management_App List API](https://apis.io/apis/esper/esper-apps-management-app-list-api/)
- [Esper apps_management_Apple App Store API](https://apis.io/apis/esper/esper-apps-management-apple-app-store-api/)
- [Esper apps_management_Esper Apps API](https://apis.io/apis/esper/esper-apps-management-esper-apps-api/)
- [Esper apps_management_OEM Config Schema API](https://apis.io/apis/esper/esper-apps-management-oem-config-schema-api/)
- [Esper apps_management_Preferred Regions API](https://apis.io/apis/esper/esper-apps-management-preferred-regions-api/)
- [Esper apps_management_Provisioning Profiles API](https://apis.io/apis/esper/esper-apps-management-provisioning-profiles-api/)
- [Esper apps_management_Tenant Apps API](https://apis.io/apis/esper/esper-apps-management-tenant-apps-api/)
- [Esper apps_management_Tenant Esper Apps API](https://apis.io/apis/esper/esper-apps-management-tenant-esper-apps-api/)
- [Esper apps_management_VPP App Management API](https://apis.io/apis/esper/esper-apps-management-vpp-app-management-api/)
- [Esper apps_management_VPP License Management API](https://apis.io/apis/esper/esper-apps-management-vpp-license-management-api/)
- [Esper Apps Management Webclips API](https://apis.io/apis/esper/esper-apps-management-webclips-api/)
- [Esper blueprints_Background Scripts API](https://apis.io/apis/esper/esper-blueprints-background-scripts-api-api/)

## Tags

pipelines_Stage Runs

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/esper/esper-pipelines-stage-runs-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/esper/.