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 Step
TestMu AI
StatusCommunityBlog
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
Test Runs

Update Test Run Step

Updates a single step inside a test run instance - its execution status and the remarks logged against it. All body fields are optional; send only the fields you want to change. Retrieve the test_run_step_id from the test_build_steps array returned by GET /api/v1/test-run/test-run-instance/{test_instance_id}.

PUT
/api/v1/test-run/test-run-step/{test_run_step_id}
Update Test Run Step
curl --request PUT \
  --url "https://test-manager-api.lambdatest.com/api/v1/test-run/test-run-step/{test_run_step_id}" \
  --header "Authorization: Basic <encoded-value>" \
  --header "Content-Type: application/json" \
  --data '{
    "status": "Failed",
    "remarks": "<p>Step failed - element not found on the checkout page</p>"
  }'
{
  "message": "Test Run Step 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_step_idstringrequired

ID of the step within the test run instance to update.

Body

application/json
statusenum<string>

Execution status to set on the step.

PassedFailedSkippedNot Started
remarksstring

Remarks logged against the step. Accepts HTML markup - the Test Manager UI renders this as rich text, so wrap plain text in a tag such as <p>.

Response

application/json

OK

messagestring
Example: "Test Run Step updated successfully"
typestring
Example: "Success"
Update Test Run Step
curl --request PUT \
  --url "https://test-manager-api.lambdatest.com/api/v1/test-run/test-run-step/{test_run_step_id}" \
  --header "Authorization: Basic <encoded-value>" \
  --header "Content-Type: application/json" \
  --data '{
    "status": "Failed",
    "remarks": "<p>Step failed - element not found on the checkout page</p>"
  }'
{
  "message": "Test Run Step updated successfully",
  "type": "Success"
}