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

# Recover an incomplete Kato task

> Check completed changes, resolve the blocked dependency and resume only the remaining work.

When Kato cannot finish a task, inspect what already happened before retrying. A failed reply or unfinished setup can leave useful resources and submitted work behind. Resume from the recorded state to avoid repeating changes unintentionally.

Replace bracketed fields in example requests with your resource names or identifiers before sending.

## Establish what happened

Return to the Kato conversation and identify the last intended operation. Ask:

> Inspect the \[workspace name] setup we were working on. List the resources created or reused, their identifiers, any work already submitted and the operations still incomplete. Do not create, start, retry or delete anything.

Open the returned resources and check their actual configuration and work records. Use [Find resources and track work with Kato](/kato/find-and-track-work). If a response was interrupted, do not assume that the operation was cancelled or that its effects were reversed.

## Resolve the specific dependency

| Blocker | Next action |
| - | - |
| Missing or ambiguous target | Supply the exact workspace, dataset, definition, job or run identifier. Confirm which existing resource to use. |
| Insufficient product or resource access | Ask the relevant Owner or administrator for the grant needed for the operation. Recheck access before resuming. |
| Unsupported source or invalid configuration | Choose a supported source/configuration and confirm its limits. A proposed source is not a working connection. |
| Missing credential | Ask an Admin to set the declared secret name in Console. Provide the name to Kato, without its value. |
| Failed or partial collection/processing | Inspect retained inputs and the affected attempts. Decide which remaining work to retry and what it may repeat. |
| Evaluation did not meet criteria | Revise the candidate and rerun the relevant cases; retain failed results and the tested version. |
| Waiting for approval or review | Inspect the requested action or exact review subject and use the appropriate decision controls. |
| Usage or execution limit | Inspect recorded usage and the limit reached. Narrow the task or agree a permitted limit before resubmitting. |

Kato cannot grant itself missing authority or manage passwords, sessions, MFA or API keys. [How Kato uses context and permissions](/kato/context-and-permissions) explains the boundary.

## Request only the remaining work

Restate the goal, the existing resource identities and the unfinished operation. Keep successful changes in place unless you intend to alter them. For example:

> Reuse the existing \[workspace name] workspace and \[collection name] collection with the identifiers above. Attach only \[dataset name or identifier] that was missing. Keep the scope and any exact period we agreed for my data. Do not recreate resources or start collection or processing.

For a retry, specify the affected job/run or binding and permitted scope. Inspect what may repeat, including model calls, collection or external effects. A retry is not a guarantee that every earlier action is skipped. Request cleanup as its own operation; Kato has no general promise of automatic rollback.

## Verify the recovered state

Open the target and check that the remaining change completed, the intended identities were reused and existing settings still match the goal. Inspect any newly submitted work separately. Record remaining gaps rather than treating partial or empty input as evidence that nothing happened.

If work remains blocked, retain the identifiers and diagnostic details for the appropriate resource Owner or administrator. Continue with [workspace preparation](/kato/prepare-workspace), [ingestion setup](/kato/set-up-ingestion) or [workflow testing](/kato/build-workflow) from the verified state.


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