Skip to main content
When a run fails, the Maintenance Agent wakes up, labels the failure, and triggers the right recovery path - notify, auto‑repair, or retry. You can change the recovery settings for each workflow in our platform by navigating to the workflow and then clicking on “Error Handling”.

​
Error code generation

In case the error is a User Error and there’s no matching error code, maintenance agent will suggest a new error code. You can approve these error codes in our platform. Once approved, the error code is returned in future runs in the execution.failed webhook.

​
Error‑classification matrix

CategorySub‑categoryDescription
User ErrorPAGE_NOT_FOUNDURL returns 404; usually bad ID/slug
AUTHENTICATION_ERRORWrong or expired credentials, unexpected 2FA, captcha, password reset
INCORRECT_FORM_INPUTSProvided value empty, invalid, or fails validation
PASSWORD_UPDATE_REQUIREDSite forces password change before further access
ADDITIONAL_USER_INPUT_REQUIREDUnexpected gating modal that truly blocks progress
MULTIPLE_MATCHING_RESULTS_FOUNDAmbiguous search results require human or AI disambiguation
ACTION_BLOCKED_BY_PLATFORMPlatform rejects duplicate or forbidden action
Workflow ErrorACTION_PERFORMED_TOO_EARLYClicked before element was fully loaded
UNEXPECTED_POPUPOptional modal (survey, promo, cookie banner) appeared
UNEXPECTED_UI_STATELayout/state differs (already logged in, collapsed sidebar)
XPATH_INCORRECTSelector matches 0 or >1 elements
External ErrorSERVICE_UNAVAILABLEUpstream system down or non‑responsive
PAGE_STILL_LOADINGThe workflow ended in a loading state
ACCOUNT_LOGGED_OUTThe website logged out the account unexpectedly

​
Recovery playbook

ClassificationAction
User ErrorSurface a dashboard alert + notification; ask the user to correct data or credentials.
Workflow ErrorAuto‑patch the graph: update selectors or insert waits.
External ErrorSchedule exponential back‑off retries; no graph change.
Note, that if the workflow is retried, its status will be execution.requeued until the run is started again.
⌘I