---
title: "Start a Test Run"
method: POST
path: "/start"
---

# Start a Test Run

`POST /start`

Starts a new test run job for the specified test suites or individual tests.  You must provide either an array of `testSuiteIds`, an array of `testIds`, or both.

## Headers

- `x-correlation-id` string

## Request body

- object
  - `testSuiteIds` string[] — A list of Test Suite IDs to be executed.
  - `testIds` string[] — A list of individual Test IDs to be executed.

## Response `200`

The test run job has been successfully created and queued.

- object
  - `testRunId` string — The ID of the newly created test run job.
  - `status` 'WAITING' | 'RUNNING' | 'COMPLETED' | 'CANCELING' | 'CANCELED' | 'ERROR'

## Other responses

- `400` — Business error. Missing parameters or rule resolution failed.
- `401` — Unauthorized. Invalid or missing API key.

---

[API](https://skmtc.dev/decisionrules/apis/decisionrules-rule-solver-api.md) · [All operations](https://skmtc.dev/decisionrules/apis/decisionrules-rule-solver-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decisionrules/decisionrules-rule-solver-api/revisions/b50a7df65838/schema)