Skip to main content
Rerun a previous run: either all tests again or only the tests that failed (or were skipped/errored). Useful for flaky test verification or re-running failed tests after a fix.
  • Endpoint: POST /run/{shortId}
  • Authentication: Bearer token required
  • Base URL: https://api.qa.tech/v1

​
Path Parameters

ParameterTypeRequiredDescription
shortIdstringYesThe run’s short ID (from Start Run response: run.shortId)

​
Request Body

FieldTypeRequiredDescription
failedOnlybooleanNoIf true, rerun only failed/skipped/error test cases.
projectTestCaseIdsarray of strings (UUIDs)NoRerun only these test cases (by project test case ID).
You must provide either failedOnly or projectTestCaseIds, but not both. Sending both returns 400 Bad Request.
To rerun the entire run with no filters, send an empty JSON object {} as the request body.

​
Response

​
Success (200)

{
  "success": true,
  "run": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "shortId": "def456",
    "url": "https://app.qa.tech/p/your-project/results/def456",
    "testCount": 3
  }
}
Use run.shortId to get run status or trigger another rerun.

​
Error Responses

StatusDescription
400Validation error, or both failedOnly and projectTestCaseIds provided, or no tests to rerun.
401Missing or invalid API key.
402Usage limit exceeded.
403Invalid token or organization suspended.
404Run or project not found.
500Server error.

​
Example: Rerun Failed Tests Only

curl -X POST "https://api.qa.tech/v1/run/abc123" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"failedOnly": true}'

​
Example: Rerun Specific Test Cases

curl -X POST "https://api.qa.tech/v1/run/abc123" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "projectTestCaseIds": [
      "a1b2c3d4-e5f6-4789-a012-3456789abcde",
      "b2c3d4e5-f6a7-4890-b123-456789abcdef"
    ]
  }'