Runs

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.

Get run

get

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/runs/{runId}

Get a single run by ID with full details

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Path parameters

runIdstringRequired

The run ID

Example: run_abc123

Responses

200

Successful response

application/json

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

get

/runs/{runId}

HTTPcURLJavaScriptPython

GET /v1/runs/{runId} HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "OK",
  "data": {
    "runId": "text",
    "projectId": "text",
    "createdAt": "2026-01-08T01:41:22.659Z",
    "durationMs": 1,
    "deletedAt": "2026-01-08T01:41:22.659Z",
    "tags": [
      "text"
    ],
    "previousRunId": "text",
    "timeout": {
      "isTimeout": true,
      "timeoutValueMs": 1
    },
    "cancellation": {
      "cancelledAt": "2026-01-08T01:41:22.659Z",
      "cancelledBy": "text",
      "reason": "text"
    },
    "groups": [
      {
        "groupId": "text",
        "platform": {
          "osName": "text",
          "osVersion": "text",
          "browserName": "text",
          "browserVersion": "text"
        },
        "tests": {
          "overall": 1,
          "passes": 1,
          "failures": 1,
          "pending": 1,
          "skipped": 1,
          "flaky": 1
        }
      }
    ],
    "meta": {
      "ciBuildId": "text",
      "commit": {
        "sha": "text",
        "branch": "text",
        "authorName": "text",
        "authorEmail": "text",
        "message": "text",
        "remoteOrigin": "text"
      },
      "framework": {
        "name": "text",
        "version": "text"
      }
    },
    "specs": [
      {
        "spec": "text",
        "groupId": "text",
        "instanceId": "text",
        "machineId": "text",
        "claimedAt": "2026-01-08T01:41:22.659Z",
        "completedAt": "2026-01-08T01:41:22.659Z",
        "results": {
          "stats": {
            "tests": 1,
            "passes": 1,
            "failures": 1,
            "pending": 1,
            "skipped": 1
          },
          "exception": "text",
          "flaky": 1
        }
      }
    ],
    "completionState": "complete",
    "status": "passed"
  }
}

Delete run

delete

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/runs/{runId}

Delete a run and all associated data

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Path parameters

runIdstringRequired

The run ID

Example: run_abc123

Responses

200

Run deleted successfully

application/json

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

delete

/runs/{runId}

HTTPcURLJavaScriptPython

DELETE /v1/runs/{runId} HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "OK",
  "data": {
    "runId": "text"
  }
}

Find run

get

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/runs/find

Find a run by query parameters. Returns the most recent completed run matching the criteria.

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Query parameters

projectIdstringRequired

The project ID

Example: proj_abc123

ciBuildIdstringOptional

The CI build ID. If provided, returns the run with this exact ciBuildId.

branchstringOptional

Git branch name. Used when ciBuildId is not provided.

tagstring[]Optional

Run tags to filter by (can be specified multiple times)

pwLastRunbooleanOptional

If true, includes information about failed tests from the last run (Playwright only)

Responses

200

Successful response

application/json

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

get

/runs/find

HTTPcURLJavaScriptPython

GET /v1/runs/find?projectId=text HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "OK",
  "data": {
    "runId": "text",
    "projectId": "text",
    "createdAt": "2026-01-08T01:41:22.659Z",
    "durationMs": 1,
    "deletedAt": "2026-01-08T01:41:22.659Z",
    "tags": [
      "text"
    ],
    "previousRunId": "text",
    "timeout": {
      "isTimeout": true,
      "timeoutValueMs": 1
    },
    "cancellation": {
      "cancelledAt": "2026-01-08T01:41:22.659Z",
      "cancelledBy": "text",
      "reason": "text"
    },
    "groups": [
      {
        "groupId": "text",
        "platform": {
          "osName": "text",
          "osVersion": "text",
          "browserName": "text",
          "browserVersion": "text"
        },
        "tests": {
          "overall": 1,
          "passes": 1,
          "failures": 1,
          "pending": 1,
          "skipped": 1,
          "flaky": 1
        }
      }
    ],
    "meta": {
      "ciBuildId": "text",
      "commit": {
        "sha": "text",
        "branch": "text",
        "authorName": "text",
        "authorEmail": "text",
        "message": "text",
        "remoteOrigin": "text"
      },
      "framework": {
        "name": "text",
        "version": "text"
      }
    },
    "specs": [
      {
        "spec": "text",
        "groupId": "text",
        "instanceId": "text",
        "machineId": "text",
        "claimedAt": "2026-01-08T01:41:22.659Z",
        "completedAt": "2026-01-08T01:41:22.659Z",
        "results": {
          "stats": {
            "tests": 1,
            "passes": 1,
            "failures": 1,
            "pending": 1,
            "skipped": 1
          },
          "exception": "text",
          "flaky": 1
        }
      }
    ],
    "completionState": "complete",
    "status": "passed"
  }
}

Cancel run

put

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/runs/{runId}/cancel

Cancel a run in progress

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Path parameters

runIdstringRequired

The run ID

Example: run_abc123

Responses

200

Run cancelled successfully

application/json

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

put

/runs/{runId}/cancel

HTTPcURLJavaScriptPython

PUT /v1/runs/{runId}/cancel HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "OK",
  "data": {
    "runId": "text",
    "cancelled": true,
    "cancelledAt": "2026-01-08T01:41:22.659Z"
  }
}

Reset run

put

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/runs/{runId}/reset

Reset failed spec files in a run to allow re-execution. Requires specifying machineId(s) to reset.

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Path parameters

runIdstringRequired

The run ID

Example: run_abc123

Body

application/json

machineIdstring[] · min: 1 · max: 63Required

Machine ID(s) to reset

isBatchedOr8nbooleanOptional

Whether to use batched orchestration

Responses

200

Run reset successfully

application/json

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

put

/runs/{runId}/reset

HTTPcURLJavaScriptPython

PUT /v1/runs/{runId}/reset HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "machineId": [
    "text"
  ],
  "isBatchedOr8n": true
}

{
  "status": "OK",
  "data": {}
}

Cancel run by GitHub CI

put

https://api.currents.dev/v1https://api-staging.currents.dev/v1http://localhost:4000/v1

/runs/cancel-ci/github

Cancel a run by GitHub Actions workflow run ID and attempt number

Authorizations

BearerAuth

AuthorizationstringRequired

API key authentication using Bearer token

Body

application/json

githubRunIdstringRequired

GitHub Actions workflow run ID

githubRunAttemptintegerRequired

GitHub Actions workflow run attempt number

projectIdstringOptional

Optional project ID to scope the cancellation

ciBuildIdstringOptional

Optional CI build ID to scope the cancellation

Responses

200

Run cancelled successfully

application/json

400

Invalid request parameters

application/json

401

Authentication failed

application/json

404

Resource not found

application/json

put

/runs/cancel-ci/github

HTTPcURLJavaScriptPython

PUT /v1/runs/cancel-ci/github HTTP/1.1
Host: api.currents.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 81

{
  "githubRunId": "text",
  "githubRunAttempt": 1,
  "projectId": "text",
  "ciBuildId": "text"
}

{
  "status": "OK",
  "data": {
    "runId": "text",
    "cancelled": true,
    "cancelledAt": "2026-01-08T01:41:22.659Z"
  }
}