Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

TestRail Runs API

Executions of a set of test cases (test runs).

TestRail Runs API is one of 11 APIs that TestRail publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Runs. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 6 operations across 6 paths. It is described by OpenAPI 3.0.3, at version 2.0.

Requests are made against 2 base URLs: https://{instance}.testrail.io/index.php?/api/v2, https://{host}/index.php?/api/v2.

6 operations 6 paths 0 schemas 2 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0
Base URL
https://{instance}.testrail.io/index.php?/api/v2
Authentication
HTTP Basic
Resource Areas
1

Authentication & Security 1

TestRail Runs API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (basicAuth). By default, every request must be authenticated.

  • basicAuth — HTTP Basic authentication. Username is your TestRail email; password is your account password or an API key generated under My Settings. The API must be enable…

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 2 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Runs 6

Executions of a set of test cases (test runs).

GET
/get_runs/{project_id}
Get runs
getRuns 4 params → 200
GET
/get_run/{run_id}
Get run
getRun 1 param → 200
POST
/add_run/{project_id}
Add run
addRun 1 param body → 200
POST
/update_run/{run_id}
Update run
updateRun 1 param body → 200
POST
/close_run/{run_id}
Close run
closeRun 1 param → 200
POST
/delete_run/{run_id}
Delete run
deleteRun 1 param → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

testrail-runs-api-openapi.yml Raw ↑

Other APIs TestRail publishes across the network.

TestRail Cases API
TestRail Configurations API
TestRail Milestones API
TestRail Plans API
TestRail Projects API
TestRail Results API
TestRail Sections API
TestRail Suites API
TestRail Tests API
TestRail Users API