> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudcruise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recovery settings

> Turn Maintenance Agent recoveries on or off for a workspace or a workflow

Workspace settings establish the recovery controls available in the dashboard. Workflow settings let you tailor those controls for an individual workflow.

| Setting | API field | Default | Customer outcome |
| - | - | - | - |
| Popup Handling | `enable_popup_handling` | `true` | Dismiss non-consequential popup blockers or request a decision |
| Action Timing Recovery | `enable_action_timing_recovery` | `true` | Wait and retry eligible actions when a page is still loading |
| XPath Recovery | `enable_xpath_recovery` | `true` | Use AI to complete eligible Click and Input Text selector failures |
| Error Code Generation | `enable_error_code_generation` | `true` | Suggest error codes for eligible unmatched failures |
| Service Unavailable Recovery | `enable_service_unavailable_recovery` | `true` | Requeue transient outages and logged-out sessions |
| Password Update Recovery | `enable_password_update_recovery` | `false` | Rotate one compatible vault credential and resume |
| Pause Credential on Login Failure | `pause_on_invalid_credentials`, `pause_on_password_update` | `false` | Stop queued runs from retrying a login that cannot work. Set per workflow through the Workflow API, or workspace-wide under **Settings → Error Handling**. See [Pausing](https://docs.cloudcruise.com/concepts/maintenance-agent/pausing.md) |
| Decision Required | `enable_decision_required_recovery` | `true` | Ask a person to decide when a recovery needs a choice. See [Decision Required](https://docs.cloudcruise.com/concepts/decision-required.md) |

See [Workflow Settings](https://docs.cloudcruise.com/concepts/workflow-dsl/workflow-settings.md#recovery-toggles) for the complete API-field reference.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.