Start Run API
The Start Run API allows you to programmatically trigger test runs for your projects. This endpoint is particularly useful for integrating QA.tech testing into your CI/CD pipelines and custom automation workflows. The Start Run API provides a single endpoint to create new test runs:- Endpoint:
POST /projects/{projectId}/runs
- Authentication: Bearer token (JWT)
- Content-Type:
application/json
Authentication
The Start Run API uses Bearer token authentication. Include your project’s API token in theAuthorization
header:
Request Parameters
Path Parameters
Parameter | Type | Required | Description |
---|---|---|---|
projectId | string | Yes | The unique identifier of your QA.tech project |
Headers
Header | Value | Required | Description |
---|---|---|---|
Content-Type | application/json | Yes | Media type of the request body |
Request Body
The request body is optional and can contain the following fields:Optional Fields
integrationName
(string): Human-readable name of what triggered this test (defaults to “API”)testPlanShortId
(string): The short ID of the test plan to executeapplications
(object): Optional application environment overrides for testing specific environments. Each application can specify either a new environment (withurl
andname
) or reference an existing environment (withshort_id
).