---
title: "Troubleshooting"
section: "Maintenance"
description: "Fixes for SmartestQA Maintain: auto-heal decisions, run-log reasons a step was not healed, AI step conversion errors and Network to API test warnings."
url: https://docs.smartestqa.ai/en/maintenance-troubleshooting.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "auto-heal error not healed decision could not be saved records could not be loaded ai not sure enough candidates too close effect check convert to action error network to api warning authtoken baseurl"
---
# Maintenance: Troubleshooting

Find the message or symptom you see. Each entry says why it happens, what to check and how to fix it.

## In short

**On this page you can**

- Fix load and save errors on the Auto-heal , AI Steps and Network Calls tabs.
- Find out why a failed step was not repaired, from its run-log reason.
- Handle a test that fails again after you rejected a repair.
- Solve conversion errors from Save as Action .
- Act on every warning in the Network → API steps dialog.

**How to use it**

1. Copy the exact message from the screen or the run log.
2. Find it below; the section follows the tab or the run log.
3. Read Why, do the Check, then apply the Fix.
4. Still stuck: write to info@smartestqa.ai with the project name and the run ID.

## Auto-heal tab

### Problem: “Auto-heal records could not be loaded” _(Auto-heal)_

- **Why:** The list request failed: the connection dropped, your session expired, or the project is not in your company. The tab shows the error instead of “Nothing waits for review”, so you never mistake an error for an empty queue.
- **Check:** Other pages load; the project selector shows the project you expect.
- **Fix:** Click **Retry**. If it fails again, reload the page and log in again.

### Problem: “The decision could not be saved” _(Auto-heal)_

- **Why:** The text after the colon says why. “Auto-heal record #*n* is already APPROVED” (or REJECTED, PROMOTED, SUPERSEDED): someone else, an [AI assistant](https://docs.smartestqa.ai/en/mcp.html) or the runner decided it first. Only repairs that are [**Waiting for review**](https://docs.smartestqa.ai/en/maintenance-auto-heal.html#statuses) can be decided. “Access denied” or “not found”: the repair belongs to another project or company.
- **Fix:** Change the filter to **All** to see the current status and who decided. If the repair was [replaced](https://docs.smartestqa.ai/en/maintenance-auto-heal.html#replaced), decide the newer card instead.

### Problem: A step failed, but “Nothing waits for review” _(Auto-heal)_

- **Why:** The runner refused to repair, or the repair was not saved. A card is created only when a repair passes every stage of [How auto-heal decides](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#stages).
- **Check:** 1. The project type: MOBILE projects are not healed; DESKTOP is healed only with [**Auto-Heal**](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#settings) on ([project types](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#project-types)).
  2. The failed step’s [run log](https://docs.smartestqa.ai/en/report-steps.html#log-detail): find “auto-heal did not repair the step — …” and look up the reason in [Run-log reasons](https://docs.smartestqa.ai/en/maintenance-troubleshooting.html#runner-messages).
  3. The step type: only steps that find an element are healed. [API, database, mail and AI steps](https://docs.smartestqa.ai/en/automate-steps.html#step-families) are not.
  4. An [assertion](https://docs.smartestqa.ai/en/automate-steps-assertions.html#comparison-rules) that failed on a real difference is not a repair case.
- **Fix:** Act on the logged reason. To repair by hand, add a working locator in [Discover › Action List](https://docs.smartestqa.ai/en/discover-actions.html#manual-action).

### Problem: The test fails again after I rejected a repair _(Auto-heal)_

- **Why:** That is expected. Reject puts the action’s old, broken locators back: “The next run will fail on this step until the test is fixed.” If the runner can find the element again, it may instead [make the same repair again](https://docs.smartestqa.ai/en/maintenance-troubleshooting.html#fix-repaired-again).
- **Fix:** Open the action in [Discover › Action List](https://docs.smartestqa.ai/en/discover-actions.html#manual-action) and add a locator that finds the right control, or change the step in [Automate](https://docs.smartestqa.ai/en/automate-editor.html#edit-steps). See [What Reject changes](https://docs.smartestqa.ai/en/maintenance-auto-heal.html#reject).

### Problem: I rejected a repair, and the next run made the same repair again _(Auto-heal)_

- **Why:** The runner does not remember rejections. Reject restored the broken locator, so the next run found it broken, found the same element again and saved the same repair.
- **Fix:** Rejecting is not enough on its own. Fix the action’s locators in [Discover › Action List](https://docs.smartestqa.ai/en/discover-actions.html#manual-action), or fix the app if the repair pointed at the wrong control.

### Problem: The same assertion creates a new card on every run _(Auto-heal)_

- **Why:** An assertion repair changes nothing in the test. On each run the same two texts pass again on format alone, and each pass is recorded. Rejecting a card does not stop it either.
- **Fix:** If the new format is correct, change the [expected value in Automate](https://docs.smartestqa.ai/en/automate-steps-assertions.html#assertion-step) to the format the app shows now. If it is wrong, [report it as a defect](https://docs.smartestqa.ai/en/tasks-detail.html#new-task). See [Assertions](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#assertions).

### Problem: The healed tag or the InSight line does not go away _(Auto-heal)_

- **Why:** The tag stays while the test case has at least one repair waiting; the [InSight line](https://docs.smartestqa.ai/en/insight-execution.html#run-environment) stays while any repair in the project waits. One test case can have several waiting repairs, one per action plus assertion repairs.
- **Fix:** Filter [**Waiting for review**](https://docs.smartestqa.ai/en/maintenance-auto-heal.html#statuses) and decide every card of that test case. See [The healed tag](https://docs.smartestqa.ai/en/maintenance-auto-heal.html#healed-tag) and [the count](https://docs.smartestqa.ai/en/maintenance-numbers.html#banner).

### Problem: An older repair is waiting for review again _(Auto-heal)_

- **Why:** You rejected a repair that had [replaced](https://docs.smartestqa.ai/en/maintenance-auto-heal.html#replaced) an earlier one. Reject restored the locators as they were, and those include the earlier repair, so it is in use again and waits for a decision.
- **Fix:** Review it like any other card. Reject it too if that locator is also wrong.

### Problem: A card shows “—” instead of a test case name _(Auto-heal)_

- **Why:** The repair is not linked to a test case. Desktop repairs are recorded this way; their card shows the method [**Previous auto-heal engine**](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#project-types).
- **Fix:** Use the action and page names on the card’s second line, and the run ID in **Details**, to [find where it ran](https://docs.smartestqa.ai/en/report-list.html#find-a-run).

### Problem: “Only an absolute XPath identifies this element. Adding a data-testid to it would make the test stable.” _(Auto-heal)_

- **Why:** The element has no stable attribute; only its position in the page identifies it. Such a locator breaks on the next layout change, so the runner uses it for the current run only and does not save it.
- **Fix:** Ask the developers for a `data-testid`, `id` or `aria-label` on the element, then add it as a locator in [Action Detail](https://docs.smartestqa.ai/en/discover-actions.html#manual-action).

### Problem: A wrong repair was confirmed by runs _(Auto-heal)_

- **Why:** Confirmation counts runs in which the new locator found an element. It cannot tell that the test checks the wrong thing. A confirmed repair can no longer be rejected.
- **Fix:** Correct the action’s locators in [Discover › Action List](https://docs.smartestqa.ai/en/discover-actions.html#manual-action). Review waiting cards before three runs pass.

## Run-log reasons a step was not healed

When the runner does not repair a step, the step fails with “Element not found: … — auto-heal: *reason*” and the log line “auto-heal did not repair the step — *reason*”. The stages are explained in [How auto-heal decides](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#stages).

### Problem: “not healed — the page itself returned HTTP …” / “the application's API returned a server error” / “the page shows an error message” / “the session ended” _(Run log)_

- **Why:** The [page check](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#page-check) found that the app itself is broken or logged out. Repairing would hide a defect, so the step fails on purpose.
- **Fix:** Treat it as a [defect](https://docs.smartestqa.ai/en/tasks-detail.html#new-task) in the app or the environment. For “the session ended”, check the test user and the session timeout, and log in again earlier in the test.

### Problem: “no element with the same identity, and AI auto-heal is turned off” / “… and AI service is not available” _(Run log)_

- **Why:** No exact match was found, and the AI stage could not run: [**Enable AI**](https://docs.smartestqa.ai/en/project-settings-ai.html#enable-ai) or [**Auto-Heal**](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#settings) is off for this run, or the AI provider could not be reached.
- **Fix:** Turn both on in [Project Panel › AI Options](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#settings), or in the [pipeline’s settings](https://docs.smartestqa.ai/en/schedule-settings.html#ai-options). If they are on, check the [AI account](https://docs.smartestqa.ai/en/project-settings-ai.html#ai-account) in the same place.

### Problem: “AI is not sure enough (best … < 85)” / “two candidates are too close (best …, second …; needs a lead of 15)” _(Run log)_

- **Why:** The AI did not find one clear winner. See [the acceptance rule](https://docs.smartestqa.ai/en/maintenance-numbers.html#ai-score). Common causes: the control was removed, renamed beyond recognition, or several similar controls sit side by side.
- **Fix:** Check the app. If the control is still there, [add a locator by hand](https://docs.smartestqa.ai/en/discover-actions.html#manual-action); if several look alike, use one that includes distinguishing text or a `data-testid`.

### Problem: “no 'type' element is visible on the page” (or 'click', 'select'…) _(Run log)_

- **Why:** No visible element on the page suits the step type, for example no input field for a Type step. The page may not have loaded, or a dialog covers it.
- **Fix:** Look at the step’s [screenshot in the report](https://docs.smartestqa.ai/en/report-steps.html#screenshots). Add a [wait](https://docs.smartestqa.ai/en/automate-steps-flow.html#waits) or the missing [navigation step](https://docs.smartestqa.ai/en/automate-steps-browser.html#navigate) before it.

### Problem: “the AI gave no usable answer” / “the AI scored only n of m candidates” _(Run log)_

- **Why:** The AI reply was empty, unreadable, or incomplete. A missing score would make the 15-point lead automatic, so an incomplete reply is refused.
- **Fix:** Run again. If it repeats, check the AI model and token limit in **Project Panel** › [**AI Options**](https://docs.smartestqa.ai/en/project-settings-ai.html).

### Problem: “could not build a locator that matches only the chosen element” / “the chosen element could not be used” _(Run log)_

- **Why:** The winner was found, but every locator the runner could build also matched other elements, or the element could not be used.
- **Fix:** Add a unique attribute to the element, or [a locator by hand](https://docs.smartestqa.ai/en/discover-actions.html#manual-action) that includes its text or its container.

### Problem: “the repaired element did not behave like the original (…); nothing was saved” _(Run log)_

- **Why:** The [effect check](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#effect-check) failed: for example “last time this step opened another page; this time the page did not change”. The element was probably the wrong one.
- **Fix:** Nothing was changed. Check the app and [fix the locator by hand](https://docs.smartestqa.ai/en/discover-actions.html#manual-action).

### Problem: “step repaired for this run, but the locator was not saved” _(Run log)_

- **Why:** The step passed with the repaired element, but the locator was not written to the action. The detail line says why: “no stable locator for this element (only a position-based XPath)…”, or a server error while saving.
- **Fix:** For a position-based XPath, see [the data-testid entry](https://docs.smartestqa.ai/en/maintenance-troubleshooting.html#fix-fragile-note). For a save error, the next run tries again.

### Problem: “the step failed after auto-heal — the new locator was not saved” _(Run log)_

- **Why:** The element was found again, but the step itself still failed with it, for example a [Get step](https://docs.smartestqa.ai/en/automate-steps-browser.html#get) whose value did not match. A repair is saved only when its step passes.
- **Fix:** Read the step’s error in the [report](https://docs.smartestqa.ai/en/report-steps.html#step-table) and fix the cause.

## AI Steps

### Problem: “The list could not be loaded.” _(AI Steps · Network Calls)_

- **Why:** The request for the AI Steps or Network Calls list failed.
- **Fix:** Click **Retry**. If it fails again, reload the page and log in again.

### Problem: My AI step is not listed (“No AI step is waiting to be converted.”) _(AI Steps)_

- **Check:** 1. It is a WEB project and the step is an [AI Do step](https://docs.smartestqa.ai/en/automate-steps-ai.html#ai-do) (it performs an action). Ask, Check and Chat steps have no element to save.
  2. It passed in a **pipeline or scheduled run**. [Dry Run](https://docs.smartestqa.ai/en/automate-dry-run.html#what-runs) results are not saved.
  3. It is still an AI step in its test case.
  4. Look under [**Can't convert**](https://docs.smartestqa.ai/en/maintenance-ai-steps.html#unsupported) and **Converted**.
- **Fix:** [Run the test case in a pipeline](https://docs.smartestqa.ai/en/schedule-runs.html#run-now), then reopen the tab. See [What the tab lists](https://docs.smartestqa.ai/en/maintenance-ai-steps.html#what-is-listed).

### Problem: “This step has already been converted to an action.” _(AI Steps)_

- **Why:** Someone converted it, for example in another tab. The list refreshes and the row moves to **Converted**.
- **Fix:** Nothing to do. Under **Converted** the row shows the new action as “Action #*id*”; find it in [Discover › Action List](https://docs.smartestqa.ai/en/discover-actions.html#filters).

### Problem: “This AI step cannot be saved as an action: its action type is no longer supported.” / “"…" has no action type; it stays an AI step.” _(AI Steps)_

- **Why:** The AI used a verb with no action type, such as `press_enter` or `scroll_to`. The [**Save as Action**](https://docs.smartestqa.ai/en/maintenance-ai-steps.html#convert) button is disabled. See [the list](https://docs.smartestqa.ai/en/maintenance-ai-steps.html#unsupported).
- **Fix:** Keep the AI step, or [replace it in Automate](https://docs.smartestqa.ai/en/automate-editor.html#replace-action) with a regular step or a [Python or JS step](https://docs.smartestqa.ai/en/automate-steps-code.html).

### Problem: “Only a successful AI (Do) step can be converted to an action.” _(AI Steps)_

- **Why:** No saved result shows the step passing with an action and a locator.
- **Fix:** [Run it in a pipeline](https://docs.smartestqa.ai/en/schedule-runs.html#run-now) until it passes, then convert.

### Problem: “Action saved, but the original AI step no longer existed” / “Original AI step not found, but action was created” _(AI Steps)_

- **Why:** The action and its new step were created, but the old AI step could not be found or removed, for example because the test case was edited meanwhile.
- **Fix:** Open the test case in [Automate](https://docs.smartestqa.ai/en/automate-editor.html#remove-step). If both the AI step and the new action step are there, delete the AI step.

### Problem: “You do not have permission to delete this step” _(AI Steps)_

- **Why:** The server refused the change (HTTP 403), usually because the project is not in your company or your session changed.
- **Fix:** Reload and log in again. If it repeats, ask an admin to check your [project access](https://docs.smartestqa.ai/en/company-settings-users.html#project-access).

### Problem: “Required fields are missing, please fill in all fields” and other conversion errors _(AI Steps)_

- **Why:** “Required fields are missing…”: the saved result has no locator or action. “Project ID is missing or invalid”: select the project again. “Could not save the action”, “Could not retrieve Action ID, please try again”, “Could not create the new action step”, “Operation could not be completed, a database error occurred”, “An error occurred while saving”, “Unknown AI action type, not supported”: the conversion was rolled back.
- **Fix:** Reload the tab and try again. If the same step fails twice, write to info@smartestqa.ai with the project and test case name.

## Network Calls

### Problem: My test case is not listed (“No Network capture is waiting to be converted.”) _(Network Calls)_

- **Check:** 1. The test case has a [Network step](https://docs.smartestqa.ai/en/automate-steps-network.html) (WEB projects only).
  2. It ran in a **pipeline or scheduled run**; [Dry Run](https://docs.smartestqa.ai/en/automate-dry-run.html#what-runs) results are not saved.
  3. Look under **Converted**.
- **Fix:** [Run it in a pipeline](https://docs.smartestqa.ai/en/schedule-runs.html#run-now), then reopen the tab.

### Problem: “The capture could not be loaded.” _(Network Calls)_

- **Why:** The captured calls of the test case could not be fetched, or the test case was deleted.
- **Fix:** Reload the tab and click [**Make API test**](https://docs.smartestqa.ai/en/maintenance-network-calls.html#make-api-test) again.

### Problem: “There are no requests to convert in this report. Run the Network step in "List" mode (whole session, API + pages + errors) and try again.” _(Network Calls)_

- **Fix:** Set the Network step to [List mode](https://docs.smartestqa.ai/en/automate-steps-network.html#list) in Automate, [run the test case in a pipeline](https://docs.smartestqa.ai/en/schedule-runs.html#run-now), then convert. See [Tips](https://docs.smartestqa.ai/en/maintenance-network-calls.html#tips).

### Problem: “No requests in this filter.” _(Network Calls)_

- **Fix:** Choose another filter, or **All**. Your app’s calls may have been classed as Third party when they go to another domain.

### Problem: “Requests use {{authToken}}, but no selected request produces a token.” _(Network Calls)_

- **Fix:** Also select the request marked **Login**, or enter the token in the [steps](https://docs.smartestqa.ai/en/automate-steps-api.html#request-fields) yourself. See [What gets created](https://docs.smartestqa.ai/en/maintenance-network-calls.html#result).

### Problem: “{{baseUrl}} must be defined at run time (e.g. as a suite parameter): …” _(Network Calls)_

- **Why:** You chose to replace the host with `{{baseUrl}}`. The shown address is the host that was replaced.
- **Fix:** Define `baseUrl` with that address, for example as a [suite parameter in the pipeline](https://docs.smartestqa.ai/en/schedule-settings.html#pipeline-parameters).

### Problem: “The list report has no request headers. If the app expects custom headers (tenant, language etc.), add them to the steps.” _(Network Calls)_

- **Fix:** After saving, open the [API Request steps](https://docs.smartestqa.ai/en/automate-steps-api.html#request-fields) and add the headers your API needs.

### Problem: “You need to define values for these variables: …” _(Network Calls)_

- **Why:** Masked secrets in headers, query or body became `{{variables}}`. They are also listed in the new test case’s description.
- **Fix:** Give each a value before the first run, for example as a [suite parameter](https://docs.smartestqa.ai/en/schedule-settings.html#pipeline-parameters) or [global parameter](https://docs.smartestqa.ai/en/automate-steps-variables.html#global-parameter). Never paste [production passwords](https://docs.smartestqa.ai/en/data-source-secrets.html#where-secrets-belong).

### Problem: A request is marked “truncated” _(Network Calls)_

- **Fix:** “The body is truncated in the report. Complete it after saving.” [Open the step](https://docs.smartestqa.ai/en/automate-steps-api.html#request-fields) and complete the body.

### Problem: “Could not create the API steps” _(Network Calls)_

- **Why:** Creating the test case or saving its steps failed, for example because your company’s licence limit for test cases is reached (an Admin sees the licence in [Company Settings › Billing](https://docs.smartestqa.ai/en/company-settings-billing.html)).
- **Fix:** Look in the [folder](https://docs.smartestqa.ai/en/automate-test-cases.html#folders): a test case may have been created without steps; delete it. Then try again.

### Problem: A converted test case is back in Pending _(Network Calls)_

- **Why:** The API test case created from it was deleted.
- **Fix:** Convert it again if you still need the API test. See [After the conversion](https://docs.smartestqa.ai/en/maintenance-network-calls.html#after).

Still stuck? Write to [info@smartestqa.ai](mailto:info@smartestqa.ai) with the project name, the test case and, for auto-heal, the run ID shown in the card’s **Details**.
