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

Top-level containers owning suites, cases, runs, plans, and milestones.

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

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

This API exposes 5 operations across 5 paths, and defines 1 schema. 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.

5 operations 5 paths 1 schemas 2 GET3 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 Projects 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 5

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

Projects 5

Top-level containers owning suites, cases, runs, plans, and milestones.

GET
/get_projects
Get projects
getProjects 2 params → 200401
GET
/get_project/{project_id}
Get project
getProject 1 param → 200400
POST
/add_project
Add project
addProject body → 200403
POST
/update_project/{project_id}
Update project
updateProject 1 param body → 200
POST
/delete_project/{project_id}
Delete project
deleteProject 1 param → 200

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is Error (1 property). Each schema is shown below with its type and property counts.

Error
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

testrail-projects-api-openapi.yml Raw ↑

Other APIs TestRail publishes across the network.

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