---
title: "Maintenance"
section: "Maintenance"
description: "Maintain collects what your runs found and that waits for a decision: repaired locators, AI steps to turn into actions, network captures to turn into API tests."
url: https://docs.smartestqa.ai/en/maintenance.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "maintenance maintain auto-heal self-healing locator repair review approve reject ai steps convert to action network calls api test healed tag"
---
# Maintenance

Maintain is the menu item for work that your test runs found and that waits for a person’s decision: repairs made by auto-heal, AI steps that can become regular actions, and network captures that can become API test cases.

## In short

**On this page you can**

- Review the locator and assertion repairs the runner made, in Auto-heal .
- Turn AI steps that keep passing into regular actions, in AI Steps .
- Turn a Network step’s captured calls into an API test case, in Network Calls .
- See how each repair was found, how it was checked, and who decided it.
- Jump to the right tab from the InSight banner or from a report row.

**How to use it**

1. Run your test cases and pipelines as usual; repairs and candidates collect here.
2. Open Maintain › Auto-heal and read each card under Waiting for review .
3. Click Approve for a correct repair and Reject for a wrong one.
4. In AI Steps , click Convert to Action on steps that should run without AI.
5. In Network Calls , click Make API test to build API checks from a browser test.

**At a glance**

- **Where:** Main menu › **Maintain**, right after [Report](https://docs.smartestqa.ai/en/report.html). Tabs: [**Auto-heal**](https://docs.smartestqa.ai/en/maintenance-auto-heal.html#the-screen), [**AI Steps**](https://docs.smartestqa.ai/en/maintenance-ai-steps.html#what-is-listed), [**Network Calls**](https://docs.smartestqa.ai/en/maintenance-network-calls.html#what-is-listed).
- **Who:** Everyone with access to the project, [Admin and User](https://docs.smartestqa.ai/en/company-settings-roles.html#matrix) alike. Each decision is saved with your email.
- **You need:** Test runs. Nothing appears here until a run has repaired something or produced a candidate.
- **Time:** A repair takes seconds to review. Converting an AI step or a capture takes a minute.
- **Produces:** Kept or restored locators, new actions in the [Action List](https://docs.smartestqa.ai/en/discover-actions.html#action-list), new API test cases in [Automate](https://docs.smartestqa.ai/en/automate.html).
- **Fed by:** The runner during [Dry Runs](https://docs.smartestqa.ai/en/automate-dry-run.html) and [pipeline runs](https://docs.smartestqa.ai/en/schedule-runs.html) (auto-heal), and saved pipeline results (AI Steps, Network Calls).
- **Project types:** WEB: all three tabs. DESKTOP: [**Auto-heal**](https://docs.smartestqa.ai/en/maintenance-auto-heal.html#the-screen) for locators, when [AI is on](https://docs.smartestqa.ai/en/project-settings-ai.html#enable-ai). MOBILE (Android, iOS): the runner does not heal and has no AI Steps or Network Calls candidates, so the tabs stay empty.

## Start from your question

I want to…

- [Check a locator the runner repaired](https://docs.smartestqa.ai/en/maintenance-auto-heal.html#review-a-repair)
- [Undo a wrong repair](https://docs.smartestqa.ai/en/maintenance-auto-heal.html#reject)
- [Make an AI step run without AI](https://docs.smartestqa.ai/en/maintenance-ai-steps.html#convert)
- [Build API tests from captured calls](https://docs.smartestqa.ai/en/maintenance-network-calls.html#make-api-test)
- [Turn AI auto-heal on or off](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#settings)

Something is wrong

- [A step failed but no repair appears](https://docs.smartestqa.ai/en/maintenance-troubleshooting.html#fix-no-repair)
- [“The decision could not be saved”](https://docs.smartestqa.ai/en/maintenance-troubleshooting.html#fix-decision-failed)
- [The test fails after I rejected a repair](https://docs.smartestqa.ai/en/maintenance-troubleshooting.html#fix-fails-after-reject)
- [My AI step is not in AI Steps](https://docs.smartestqa.ai/en/maintenance-troubleshooting.html#fix-ai-step-missing)
- [All Maintain problems](https://docs.smartestqa.ai/en/maintenance-troubleshooting.html)

How does it work?

- [How the runner decides to heal](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html)
- [What “2/3” on a card means](https://docs.smartestqa.ai/en/maintenance-numbers.html#promotion)
- [Why the AI picked this element](https://docs.smartestqa.ai/en/maintenance-numbers.html#ai-score)
- [What the “healed” tag means](https://docs.smartestqa.ai/en/maintenance-auto-heal.html#healed-tag)
- [Does a Dry Run heal too?](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#run-modes)

## Where Maintenance fits

The main menu is the order of work. Maintenance comes last because it works on what the runs before it found.

1. **Discover** — Pages, controls, rules
2. **Analyze** — Requirements from the map
3. **Automate** — Test cases from actions
4. **Schedule** — Pipelines
5. **Report** — Results
6. **Maintenance** — Heal and review ← this page

Each question has its own screen:

| Your question | Go to |
| --- | --- |
| What have I not set up yet? | **Discover** › [Setup Roadmap](https://docs.smartestqa.ai/en/discover.html#screen-tour) |
| How healthy are my tests? | **[InSight](https://docs.smartestqa.ai/en/insight.html)** › **[Test Health](https://docs.smartestqa.ai/en/insight-test-health.html)** |
| What did the system find that waits for a decision? | **Maintain** (this section) |
| Which work is assigned to a person? | **[Tasks](https://docs.smartestqa.ai/en/tasks.html)** |

## Why use it

- **Tests keep running when the UI changes.** When a button moves or its id changes, the runner finds the element again, checks that the step still does the same thing, and saves the new locator. You do not lose a night of [pipeline runs](https://docs.smartestqa.ai/en/schedule-timing.html) to one renamed id.
- **A person stays in control.** Every repair waits as a card with the old and the new locator side by side. You approve it, reject it, or let it confirm itself after 3 more successful runs.
- **Wrong repairs are undone exactly.** **Reject** puts the action’s locators back as they were before the repair.
- **Faster, cheaper runs.** An [AI step](https://docs.smartestqa.ai/en/automate-steps-ai.html) asks the AI on every run. Converted to an action, it runs from a saved locator with no AI call.
- **API coverage from browser tests.** A [Network step](https://docs.smartestqa.ai/en/automate-steps-network.html) already records the calls your web app makes. One dialog turns them into an API test case.

## The building blocks

- **Repair:** One change the runner made during a run and recorded for review. It is shown as a card in [**Auto-heal**](https://docs.smartestqa.ai/en/maintenance-auto-heal.html#the-screen).
- **Locator repair:** All locators of an action failed, and the runner found the element again with a new locator. The new locator is written to the action at once, so the next runs use it.
- **Assertion repair:** A [text assertion](https://docs.smartestqa.ai/en/automate-steps-assertions.html#assertion-types) passed although the two texts differ only in how they are written, for example `50 TL` and `50,00 TL`. Nothing in the test is changed.
- **Healed tag:** An amber tag named `healed` on a [test case](https://docs.smartestqa.ai/en/automate-test-cases.html) while at least one of its repairs waits for review.
- **Confirmed by runs:** A locator repair that worked in 3 more runs is confirmed without a person. See [the count](https://docs.smartestqa.ai/en/maintenance-numbers.html#promotion).
- **AI step:** A test step that tells the AI what to do in plain words (an [AI Do step](https://docs.smartestqa.ai/en/automate-steps-ai.html#ai-do)). It finds its element anew on every run.
- **Network capture:** The browser calls a [Network step](https://docs.smartestqa.ai/en/automate-steps-network.html) recorded during a run: method, address, status and bodies.
- **Action:** One control on one page with its locators. Actions live in [Discover › Action List](https://docs.smartestqa.ai/en/discover-actions.html#action-list).

## The screen

Maintain has three tabs. It opens on the tab in the address (`?tab=auto-heal`, `ai-steps` or `network`), otherwise on the tab you used last, otherwise on [**Auto-heal**](https://docs.smartestqa.ai/en/maintenance-auto-heal.html#the-screen). The address `/auto-heal` also opens the Auto-heal tab.

![Maintain › Auto-heal.](https://docs.smartestqa.ai/media/shots/MNT-SHOT-01.png)

| Tab | What it lists | Your decision |
| --- | --- | --- |
| [Auto-heal](https://docs.smartestqa.ai/en/maintenance-auto-heal.html) | Repairs the runner made: new locators and assertions that passed on format alone | **Approve** or **Reject**, or let it confirm itself |
| [AI Steps](https://docs.smartestqa.ai/en/maintenance-ai-steps.html) | AI steps that ran successfully in a pipeline and found their element, one row per step | [**Convert to Action**](https://docs.smartestqa.ai/en/maintenance-ai-steps.html#convert) |
| [Network Calls](https://docs.smartestqa.ai/en/maintenance-network-calls.html) | Test cases whose Network steps captured calls, one row per test case | [**Make API test**](https://docs.smartestqa.ai/en/maintenance-network-calls.html#make-api-test) |

Every tab has a status filter with a count on each option, a short explanation under the tab bar, and a **Retry** button if the list cannot be loaded. An empty **pending** list shows a green check: nothing waits.

## How you get here

- **From InSight.** While repairs wait, the Execution tab’s [run environment line](https://docs.smartestqa.ai/en/insight-execution.html#run-environment) and the first row of **[Fix these first](https://docs.smartestqa.ai/en/insight-test-health.html#fix-these-first)** on Test Health say “*n* auto-heal repair(s) on *m* test case(s) wait for review.” Click **Review**. The line is hidden when nothing waits.
- **From a run report.** A successful AI step row in the [step table](https://docs.smartestqa.ai/en/report-steps.html#step-table) has a [**Convert to Action**](https://docs.smartestqa.ai/en/maintenance-ai-steps.html#convert) button (“Opens this step in Maintain > AI Steps”). A Network step has [**Convert to API steps**](https://docs.smartestqa.ai/en/maintenance-network-calls.html#make-api-test) (“Opens this test case in Maintain > Network Calls”); if the case still waits, the conversion dialog opens by itself.
- **From [Automate](https://docs.smartestqa.ai/en/automate.html).** A test case with the [healed tag](https://docs.smartestqa.ai/en/maintenance-auto-heal.html#healed-tag) has a repair waiting.
- **From an AI assistant.** Through [MCP](https://docs.smartestqa.ai/en/mcp.html), `smartest_heal` lists and decides repairs. See [MCP](https://docs.smartestqa.ai/en/maintenance-faq.html#mcp).

## Before you start

| To see | You need |
| --- | --- |
| Locator repairs (web) | A run in which all locators of an action failed. The exact identity match works without AI; the AI choice needs [**Enable AI**](https://docs.smartestqa.ai/en/project-settings-ai.html#enable-ai) and [**Auto-Heal**](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#settings). See [Settings](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#settings). |
| Locator repairs (desktop) | [**Enable AI**](https://docs.smartestqa.ai/en/project-settings-ai.html#enable-ai) and [**Auto-Heal**](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html#settings) on, and an agent online. See [Install an agent](https://docs.smartestqa.ai/en/quick-start-connect.html#install-agent). |
| Assertion repairs (web) | An Equals, Contains, Starts with or Ends with [assertion](https://docs.smartestqa.ai/en/automate-steps-assertions.html#comparison-rules) that fails on format only. |
| AI Steps | A web test case with an [AI Do step](https://docs.smartestqa.ai/en/automate-steps-ai.html#ai-do) that passed in a [pipeline or scheduled run](https://docs.smartestqa.ai/en/schedule-runs.html#run-now). [Dry Run](https://docs.smartestqa.ai/en/automate-dry-run.html#what-runs) results are not saved, so they do not count. |
| Network Calls | A web test case with a [Network step](https://docs.smartestqa.ai/en/automate-steps-network.html) that ran in a pipeline or scheduled run. Use [**List** mode](https://docs.smartestqa.ai/en/automate-steps-network.html#list) to capture the whole session. |

## Best practices

#### Do

- Review [**Waiting for review**](https://docs.smartestqa.ai/en/maintenance-auto-heal.html#statuses) after each [nightly pipeline](https://docs.smartestqa.ai/en/schedule-timing.html), while you still remember the UI change.
- Open **Details** before approving a repair the AI chose.
- Reject a repair that clicked the wrong element, then fix the action in [Discover](https://docs.smartestqa.ai/en/discover-actions.html#change-and-delete).
- Ask developers to add a `data-testid` to elements that need repair often.
- Convert AI steps that have passed in several runs.
- Select the login request when you make an API test from a capture.

#### Don’t

- Approve every card without reading the change.
- Treat a confirmed repair as proof the test is right; it only proves the element was found.
- Ignore assertion repairs: the same assertion creates a new card on every run until you change the expected value.
- Rely on repairs on MOBILE projects; fix their locators in Discover.
- Convert an AI step whose element changes from run to run.

## In this section

- [Auto-heal reviews](https://docs.smartestqa.ai/en/maintenance-auto-heal.html) — Read a repair card, open its details, approve or reject it, and know what each decision changes.
- [How auto-heal decides](https://docs.smartestqa.ai/en/maintenance-how-healing-works.html) — When the runner heals a step, how it finds and checks the element, what it saves, and the settings that control it.
- [AI Steps](https://docs.smartestqa.ai/en/maintenance-ai-steps.html) — Turn AI steps that passed into regular actions, so they run from a saved locator without an AI call.
- [Network Calls](https://docs.smartestqa.ai/en/maintenance-network-calls.html) — Turn the browser calls a Network step captured into a new API test case, one test case at a time.
- [How the numbers work](https://docs.smartestqa.ai/en/maintenance-numbers.html) — Formulas and worked examples for the status counts, the 1/3 runs bar, the AI score, the InSight banner and the AI Steps and Network counts.
- [Troubleshooting](https://docs.smartestqa.ai/en/maintenance-troubleshooting.html) — Every Maintain message and symptom, and every auto-heal run-log reason, with why it happens, what to check and how to fix it.
- [FAQ, MCP & limits](https://docs.smartestqa.ai/en/maintenance-faq.html) — Questions and answers about auto-heal and conversions, the smartest_heal MCP tool and the module’s limits.
