Skip to main content
Root Cause Analysis›Trigger AI-powered RCA generation for failed tests in a scope.
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
Root Cause Analysis

Trigger AI-powered RCA generation for failed tests in a scope.

Resolves all failed tests under the provided scope (HyperExecute jobs/stages/tasks or individual test executions) and dispatches each eligible test to the AI RCA analyzer. Tests whose RCA was already generated or is currently running are skipped — credits are only charged for tests that are newly triggered. Scope: At least one of job_ids, stage_ids, task_ids, or test_ids must be provided in the JSON body. Each array is capped at 100 IDs. A scope that resolves to more than 10,000 failed tests is rejected with 413 — narrow the scope in that case. Product routing: Jobs/stages/tasks always route to the HyperExecute analyzer. test_ids route to the correct analyzer (HyperExecute or Web/Mobile automation) based on each test's stored product, so a mixed test_ids payload is supported. Credits: All-or-nothing. If the organization's available credit balance is below credits_required, a 402 is returned with the shortfall details and no tests are dispatched.

POST
/rca/generate
Trigger AI-powered RCA generation for failed tests in a scope.
curl --request POST \
  --url "https://api.lambdatest.com/insights/api/v3/public/rca/generate" \
  --header "Authorization: Basic <encoded-value>" \
  --header "Content-Type: application/json" \
  --data '{
    "job_ids": [],
    "stage_ids": [],
    "task_ids": [],
    "test_ids": []
  }'
{
  "status": "success",
  "data": {
    "total_tests": 25,
    "triggered_count": 20,
    "skipped_count": 5,
    "skipped_already_generated": 3,
    "skipped_in_progress": 2,
    "credits_estimated": 20,
    "test_ids": [
      "RMAA-AND-160849-XXXX",
      "RMAA-AND-160850-YYYY"
    ],
    "skipped_test_ids": [
      "RMAA-AND-160851-ZZZZ"
    ]
  }
}

Authorizations

Authorizationstringheaderrequired

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

Body

application/json
job_idsarray

HyperExecute job IDs whose failed tests should be analysed.

stage_idsarray

HyperExecute stage IDs whose failed tests should be analysed.

task_idsarray

HyperExecute task IDs whose failed tests should be analysed.

test_idsarray

Test execution IDs to analyse directly. Supports HyperExecute and Web/Mobile automation tests — each test is routed to the correct analyzer based on its stored product/test_type.

Response

application/json

Successful operation. Returns the dispatch summary.

statusstring
dataobject
data.total_testsnumber
Example: 25
data.triggered_countnumber
Example: 20
data.skipped_countnumber
Example: 5
data.skipped_already_generatednumber
Example: 3
data.skipped_in_progressnumber
Example: 2
data.credits_estimatednumber
Example: 20
data.test_idsstring[]
Example:
["RMAA-AND-160849-XXXX","RMAA-AND-160850-YYYY"]
data.skipped_test_idsstring[]
Example:
["RMAA-AND-160851-ZZZZ"]
Trigger AI-powered RCA generation for failed tests in a scope.
curl --request POST \
  --url "https://api.lambdatest.com/insights/api/v3/public/rca/generate" \
  --header "Authorization: Basic <encoded-value>" \
  --header "Content-Type: application/json" \
  --data '{
    "job_ids": [],
    "stage_ids": [],
    "task_ids": [],
    "test_ids": []
  }'
{
  "status": "success",
  "data": {
    "total_tests": 25,
    "triggered_count": 20,
    "skipped_count": 5,
    "skipped_already_generated": 3,
    "skipped_in_progress": 2,
    "credits_estimated": 20,
    "test_ids": [
      "RMAA-AND-160849-XXXX",
      "RMAA-AND-160850-YYYY"
    ],
    "skipped_test_ids": [
      "RMAA-AND-160851-ZZZZ"
    ]
  }
}