testrail.com

•

API Key

About TestRail

TestRail is a web-based test case management platform used by QA engineers and software development teams to organize test cases, run test cycles, track defects, and report on software quality metrics. It integrates with CI/CD tools, bug trackers (Jira, GitHub), and automation frameworks. It offers both cloud-hosted and self-managed server deployment options. There is no permanent free plan, but a free trial is available.

AI Agent Use Cases

- Test case authoring, organization, and versioning

- Test run and milestone tracking with progress reporting

- Integration with Jira, GitHub, Jenkins, and automation frameworks

- Test parameterization and reusable test suites

- Advanced audit logs and SSO (Enterprise)

- Cloud and self-hosted server deployment options

Available Actions

These are the specific actions that AI agents can perform with this tool

Get Case Fields

Retrieve a list of available custom fields for test cases in TestRail.

Get Project Details

1 input

Retrieve the details of a specific project by its ID

Inputs

project_id

The ID of the project

Get Project Information

1 input

Retrieve detailed information about a specific TestRail project using its project ID.

Inputs

project_id

The ID of the project to retrieve information for. Replace {project_id} with the actual project ID.

Get Projects

3 inputs

Retrieve the list of all projects from TestRail.

Inputs

hostname

The hostname or base URL of your TestRail instance. For example, testrail.yourcompany.com

The email address used to log into your TestRail account.

api_key

Your TestRail API key for authentication.

Get Test Case

1 input

Retrieve details of an existing test case by providing its ID.

Inputs

case_id

The ID of the test case to retrieve.

Get Test Case Details

1 input

Retrieve detailed information about a specific test case using its unique identifier.

Inputs

caseId

The unique ID of the test case you want to retrieve.

Get Test Cases for Project

17 inputs

Retrieve a list of test cases for a specific project and suite, optionally filter them by various parameters.

Inputs

project_id

The ID of the project.

suite_id

The ID of the test suite. Optional if the project is in single suite mode.

created_after

Only return test cases created after this date (as UNIX timestamp).

created_before

Only return test cases created before this date (as UNIX timestamp).

created_by

A comma-separated list of creators (user IDs) to filter by.

filter

Only return cases with matching filter string in the case title.

limit

The number of test cases the response should return (default is 250).

milestone_id

A comma-separated list of milestone IDs to filter by.

offset

Where to start counting the test cases from (the offset).

priority_id

A comma-separated list of priority IDs to filter by.

refs

A single Reference ID to filter by.

section_id

The ID of a test case section.

template_id

A comma-separated list of template IDs to filter by.

type_id

A comma-separated list of case type IDs to filter by.

updated_after

Only return test cases updated after this date (as UNIX timestamp).

updated_before

Only return test cases updated before this date (as UNIX timestamp).

updated_by

A comma-separated list of user IDs who updated test cases to filter by.

Get Test Details

1 input

Retrieve the details of a specific test by its ID

Inputs

test_id

The ID of the test

Get Test Run

1 input

Retrieve details of an existing test run by its ID

Inputs

run_id

The ID of the test run

Get Tests

4 inputs

Get a list of tests for a specific test run

Inputs

run_id

The ID of the test run

status_id

A comma-separated list of status IDs to filter by

limit

The number that sets the limit of tests to be shown (Optional, default is 250)

offset

The number that sets the position where the response should start from (Optional)