> For the complete documentation index, see [llms.txt](https://docs.goassay.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goassay.ai/use-tools/when-something-goes-wrong/troubleshooting.md). # Troubleshooting Find the guide that fixes a problem with your AI app, tool calls or payments. Start with the message shown in Assay or your AI app. These links open the guide with the full fix. | Problem | Where to fix it | | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Sign-in stalls or your session expires | [Create your account](/use-tools/get-started/create-your-account.md#if-something-goes-wrong) — reload the sign-in page and retry. | | The local AI app cannot connect or has no Assay tools | [Connect your AI app](/use-tools/get-started/connect-your-ai-app.md#if-something-goes-wrong) — check installation, browser approval and restart. | | The first free call does not appear to work | [Make your first free call](/use-tools/get-started/make-your-first-call.md#if-something-goes-wrong) — ask for an actual tool call and check its connection. | | A hosted connector cannot use paid tools | [Connect your AI app](/use-tools/get-started/connect-your-ai-app.md) — choose a free tool or a local app that can pay. | | A tool is missing, unavailable or outside your agent's access | [Find tools](/use-tools/everyday-use/find-tools.md#if-something-goes-wrong) — check the connection's tools and agent permissions. | | A deposit is still confirming or the source wallet lacks funds | [Add funds](/use-tools/get-started/add-funds.md#if-something-goes-wrong) — check USDG, ETH and chain confirmation before depositing again. | | The payment-key fingerprint does not match or approval fails | [Turn on paid calls](/use-tools/get-started/turn-on-paid-calls.md#if-something-goes-wrong) — check the intended local app and approval link. | | **Paid calls through this server are off** on a tool set or single-tool connection | [Fix a paused or refused payment](/use-tools/when-something-goes-wrong/fix-a-payment-problem.md#permission-to-pay) — allow that URL for paid calls on your computer. | | Paid calls are paused, refused or marked Owed | [Fix a paused or refused payment](/use-tools/when-something-goes-wrong/fix-a-payment-problem.md) — follow the specific payment reason. | | Raising a limit does not change what the agent can spend | [Set limits and rules](/use-tools/advanced/set-limits-and-rules.md#if-something-goes-wrong) — inspect the effective limit and its source. | | A call is missing or its charge is still unclear | [Check your spending](/use-tools/everyday-use/check-your-spending.md#if-something-goes-wrong) — clear filters and read the receipt. | | An export is unavailable or does not match the view you expected | [Statements and exports](/use-tools/everyday-use/statements-and-exports.md#if-something-goes-wrong) — check the export's period and scope. | | No external alert arrives, or reading an alert does not fix a stop | [Manage alerts and review account history](/use-tools/everyday-use/alerts-and-account-history.md#if-something-goes-wrong) — check in-app alerts and resolve the cause. | | A refund action is missing, already filed or overdue | [Get a refund or report a bad result](/use-tools/when-something-goes-wrong/get-a-refund.md#if-something-goes-wrong) — check eligibility, deadlines and the existing report. | | A withdrawal cannot be claimed or paid calls stopped after requesting it | [Withdraw funds](/use-tools/manage-your-account/withdraw-funds.md#if-something-goes-wrong) — check the wait, held money and pending request. | | A tool set still shows an old version or sharing is refused | [Create and share tool sets](/use-tools/advanced/create-and-share-toolsets.md#if-something-goes-wrong) — check the version URL and sharing requirements. | | A disconnected app still has payment permission | [Manage agents, connected apps and payment keys](/use-tools/advanced/manage-agents-apps-and-keys.md) — review app access and the payment key separately. | | The account closure checklist cannot finish | [Close your account](/use-tools/manage-your-account/close-your-account.md#if-something-goes-wrong) — resolve money, records and key checks. | ## Get help If no guide fixes the problem, contact Assay support. Include the exact message and, for a call, its reference from the receipt. ## Next Return to [Use tools](/use-tools/readme.md) to choose your next task. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.goassay.ai/use-tools/when-something-goes-wrong/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.