For AI agents and LLMs: a machine-readable index is available at llms.txt. A plain-Markdown version of any documentation page is available by appending .md to its URL.
Skip to main content
Test Runs›Update Test Run Status
TestMu AI
StatusBlog
Selenium Automation API
Automated Screenshots API
App Automation API (Real Devices)
Smart UI
Cypress Automation
User Management
Test Manager
HyperExecute
Accessibility Testing
Analytics
Performance Testing
Audit logs
Agent Testing API
Test Runs

Update Test Run Status

Updates the overall execution status of a test run. This sets the status on the test run itself - it does not change the status of the individual test run instances inside it. To update the status of a single instance use the "Update Test Run Instance" API, and to update several at once use the "Bulk Update Test Run Instances" API. Retrieve the test_run_id from GET /api/v1/projects/{project_id}/test-runs.

PUT
/api/v1/test-run/status/{test_run_id}
Update Test Run Status
curl --request PUT \
  --url "https://test-manager-api.lambdatest.com/api/v1/test-run/status/{test_run_id}" \
  --header "Authorization: Basic <encoded-value>" \
  --header "Content-Type: application/json" \
  --data '{
    "status": "Passed"
  }'
{
  "message": "Test Run updated successfully",
  "type": "Success"
}

Authorizations

Authorizationstringheaderrequired

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

test_run_idstringrequired

ID of the test run whose status you want to update.

Body

application/json
statusenum<string>required

Status to set on the test run.

PassedFailedSkippedIn ProgressNot Started

Response

application/json

OK

messagestring
Example: "Test Run updated successfully"
typestring
Example: "Success"
Update Test Run Status
curl --request PUT \
  --url "https://test-manager-api.lambdatest.com/api/v1/test-run/status/{test_run_id}" \
  --header "Authorization: Basic <encoded-value>" \
  --header "Content-Type: application/json" \
  --data '{
    "status": "Passed"
  }'
{
  "message": "Test Run updated successfully",
  "type": "Success"
}