# Currents Runs API

**Canonical:** https://apis.io/apis/currents-dev/currents-dev-runs-api/  
**Provider:** Currents — https://apis.io/providers/currents-dev/  
**Base URL:** https://api.currents.dev/v1  
**Documentation:** https://docs.currents.dev/api

Currents Runs API is one of 25 APIs that [Currents](https://apis.io/providers/currents-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Runs. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and 1 JSON Schema.

Query and manage test runs. A run represents a single execution of your test suite. Runs contain spec files which are executed across multiple instances. You can query run details, cancel runs, reset failed specs, and delete runs. Per-test outcome counters on specs (`results.stats`) use the `RecordedTestOutcome` vocabulary—see **components/schemas** for how **pending** and **skipped** differ from **failures**.

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| GET | `/projects/{projectId}/runs` | List project runs |
| GET | `/projects/{projectId}/pull-requests` | List pull requests |
| GET | `/runs/{runId}` | Get run |
| DELETE | `/runs/{runId}` | Delete run |
| GET | `/runs/find` | Find run |
| PUT | `/runs/{runId}/cancel` | Cancel run |
| PUT | `/runs/{runId}/reset` | Reset run |
| POST | `/runs/attachments` | Add attachments to the run of a CI build |
| POST | `/runs/{runId}/context-links` | Create a context link for each failed or flaky test of a run |
| POST | `/runs/{runId}/attachments` | Add attachments to a run |
| PUT | `/runs/cancel-ci/github` | Cancel run by GitHub CI |

## Machine-readable artifacts (5)

- **OpenAPI** — https://artifacts.apis.io/currents-dev/openapi/currents-dev-runs-api-openapi.yml
- **Documentation** — https://docs.currents.dev/api
- **Authentication** — https://docs.currents.dev/api/get-started/authentication
- **JSONSchema** — https://artifacts.apis.io/currents-dev/json-schema/currents-dev-create-run-context-links-response-schema.json
- **Documentation** — https://t.crts.sh/docs

## Other Currents APIs (12)

- [Currents Actions API](https://apis.io/apis/currents-dev/currents-dev-actions-api/)
- [Currents Animation API](https://apis.io/apis/currents-dev/currents-dev-animation-api/)
- [Currents Animations API](https://apis.io/apis/currents-dev/currents-dev-animations-api/)
- [Currents Attachments API](https://apis.io/apis/currents-dev/currents-dev-attachments-api/)
- [Currents Context API](https://apis.io/apis/currents-dev/currents-dev-context-api/)
- [Currents Currents Trace API](https://apis.io/apis/currents-dev/currents-dev-currents-trace-api-api/)
- [Currents Digest API](https://apis.io/apis/currents-dev/currents-dev-digest-api/)
- [Currents Download API](https://apis.io/apis/currents-dev/currents-dev-download-api/)
- [Currents Errors Explorer API](https://apis.io/apis/currents-dev/currents-dev-errors-explorer-api/)
- [Currents Filmstrip API](https://apis.io/apis/currents-dev/currents-dev-filmstrip-api/)
- [Currents Frames API](https://apis.io/apis/currents-dev/currents-dev-frames-api/)
- [Currents Instances API](https://apis.io/apis/currents-dev/currents-dev-instances-api/)

## Tags

Runs

---

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