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 Plans API

Groups of runs, optionally across configurations.

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

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

This API exposes 9 operations across 9 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.

9 operations 9 paths 0 schemas 2 GET7 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 Plans 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 9

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

Plans 9

Groups of runs, optionally across configurations.

GET
/get_plans/{project_id}
Get plans
getPlans 3 params → 200
GET
/get_plan/{plan_id}
Get plan
getPlan 1 param → 200
POST
/add_plan/{project_id}
Add plan
addPlan 1 param body → 200
POST
/update_plan/{plan_id}
Update plan
updatePlan 1 param body → 200
POST
/add_plan_entry/{plan_id}
Add plan entry
addPlanEntry 1 param body → 200
POST
/update_plan_entry/{plan_id}/{entry_id}
Update plan entry
updatePlanEntry 2 params body → 200
POST
/delete_plan_entry/{plan_id}/{entry_id}
Delete plan entry
deletePlanEntry 2 params → 200
POST
/close_plan/{plan_id}
Close plan
closePlan 1 param → 200
POST
/delete_plan/{plan_id}
Delete plan
deletePlan 1 param → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

testrail-plans-api-openapi.yml Raw ↑

Other APIs TestRail publishes across the network.

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