Skip to main content
POST
/
api
/
v1
/
test-management
/
{spaceSlug}
/
{projectId}
/
runs
curl -X POST "https://your-collabase.ch/api/v1/test-management/my-space/proj-abc123/runs" \
  -H "Authorization: Bearer cba_live_xYz123ABCD..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sprint 42 — Regression"
  }'

{
  "id": "run-001",
  "name": "Sprint 42 — Regression",
  "status": "IN_PROGRESS",
  "testProjectId": "proj-abc123",
  "createdAt": "2025-04-01T09:00:00.000Z"
}
Creates a new test run for the given project. All test cases with status READY are automatically enrolled at the moment the run is created. The run begins immediately with status IN_PROGRESS.
Only test cases in READY status are enrolled. Cases in DRAFT or other statuses are excluded. You must hold write access to the target space.

​
Path parameters

​
spaceSlug
string
required
The slug of the space the project belongs to.
​
projectId
string
required
The ID of the test project to run.

​
Request body

​
name
string
required
Name of the test run (e.g., Sprint 42 — Regression).
​
description
string
Optional description of the test run.
​
milestoneId
string
ID of a milestone to associate with this run.

​
Response

​
id
string
required
Unique identifier of the newly created test run.
​
name
string
required
Name of the test run.
​
status
string
required
Status of the run. Always IN_PROGRESS on creation.
​
testProjectId
string
required
ID of the test project this run belongs to.
​
createdAt
string
required
ISO 8601 timestamp of when the run was created.
curl -X POST "https://your-collabase.ch/api/v1/test-management/my-space/proj-abc123/runs" \
  -H "Authorization: Bearer cba_live_xYz123ABCD..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sprint 42 — Regression"
  }'

{
  "id": "run-001",
  "name": "Sprint 42 — Regression",
  "status": "IN_PROGRESS",
  "testProjectId": "proj-abc123",
  "createdAt": "2025-04-01T09:00:00.000Z"
}