# Mabl Plan Run API

**Canonical:** https://apis.io/apis/mabl/mabl-planrun-api/  
**Provider:** Mabl — https://apis.io/providers/mabl/  
**Base URL:** /  
**Documentation:** https://mabl.com

Mabl Plan Run API is one of 113 APIs that [Mabl](https://apis.io/providers/mabl/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include PlanRun. The published artifact set on APIs.io includes an OpenAPI specification.

The PlanRun API from Mabl — 18 operation(s) for planrun.

## Operations (21)

| Method | Path | Summary |
|---|---|---|
| POST | `/planRuns` | Create a plan run |
| POST | `/planRuns/duplicate` | Duplicate a plan run |
| POST | `/planRuns/external` | Record an external plan run. This endpoint will not cause tests to be executed |
| PATCH | `/planRuns/external/{id}` | Update an external plan run |
| GET | `/planRuns/workspace/{workspace_id}` | Queries plan runs |
| POST | `/planRuns/workspace/{workspace_id}/querySummaries` | Retrieve plan run summaries for a workspace |
| GET | `/planRuns/workspace/{workspace_id}/summaries` | Retrieve plan run summaries by plan ID (narrow agent path) |
| GET | `/planRuns/workspace/{workspace_id}/aggregate` | Aggregate plan run counts for a workspace (fast Datastore counts) |
| GET | `/planRuns/workspace/{workspace_id}/aggregate/daily` | Exact per-day plan run counts for a workspace (fast Spanner aggregation) |
| GET | `/planRuns/workspace/{workspace_id}/latestByEnvironment` | Latest terminal plan run per plan/environment pair for a workspace window |
| GET | `/planRuns/deployment/{deployment_id}` | Queries plan runs by deployment event |
| GET | `/planRuns/{plan_run_id}/browserState` | Get signed URLs for the browser state a plan run's tests share |
| GET | `/planRuns/{id}` | Retrieve a plan run |
| DELETE | `/planRuns/{id}` | Delete plan run |
| PATCH | `/planRuns/{id}` | Update plan run |
| POST | `/planRun/{id}/terminate` | Terminate plan run |
| PUT | `/planRun/{plan_run_id}/webhooks` | Called when a webhook completes to idempotently update the plan run status… |
| POST | `/planRun/{plan_run_id}/webhooks` | Called when a webhook completes to update the plan run status accordingly |
| POST | `/planRun/{plan_run_id}/rerun` | Called to kick off a new plan run that is identical to a previously executed run |
| PUT | `/planRun/{plan_run_id}/failureCategorization` | Categorize all failed journey runs within a plan run |
| PUT | `/planRun/deployment/{deployment_event_id}/failureCategorization` | Update all associated journey runs' failure categorizations in a deployment… |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/mabl/openapi/mabl-planrun-api-openapi.yml

## Other Mabl APIs (12)

- [Mabl API](https://apis.io/apis/mabl/mabl-api/)
- [Mabl Applications API](https://apis.io/apis/mabl/mabl-applications-api/)
- [Mabl Credentials API](https://apis.io/apis/mabl/mabl-credentials-api/)
- [Mabl Database Connections API](https://apis.io/apis/mabl/mabl-database-connections-api/)
- [Mabl Deployment Events API](https://apis.io/apis/mabl/mabl-deployment-events-api/)
- [Mabl Environments API](https://apis.io/apis/mabl/mabl-environments-api/)
- [Mabl Flows API](https://apis.io/apis/mabl/mabl-flows-api/)
- [Mabl Issues API](https://apis.io/apis/mabl/mabl-issues-api/)
- [Mabl Test Runs API](https://apis.io/apis/mabl/mabl-test-runs-api/)
- [Mabl Tests API](https://apis.io/apis/mabl/mabl-tests-api/)
- [Mabl Users API](https://apis.io/apis/mabl/mabl-users-api/)
- [Mabl Ab Test Config API](https://apis.io/apis/mabl/mabl-abtestconfig-api/)

## Tags

PlanRun

---

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