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

# v3 Errors

> Handle validation, account, revision, upstream, and partial-result failures from v3 tools.

A v3 tool can return a successful MCP transport response with `isError: true`.
Always inspect the tool result, then use `structuredContent.code` and the
associated fields rather than parsing rendered prose.

Common recovery patterns include:

* correct a validation field and call again;
* call `get_status` after a wrong-account response;
* re-read a versioned noun after a revision conflict;
* preserve per-seller or per-source outcomes from a partial result; and
* re-read after `partialWrite: true` before deciding whether to retry.

`NOT_FOUND` can intentionally hide whether an object exists outside the active
account. Do not treat it as evidence about another account.

<Card title="Full error reference" icon="book" href="/v2/reference/errors">
  Review the canonical error envelope, status mapping, retry behavior, and
  troubleshooting guidance shared with stable v2.
</Card>