> For the complete documentation index, see [llms.txt](https://www.quillaudits.com/quillshield/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.quillaudits.com/quillshield/guides/reference/troubleshooting.md).

# Troubleshooting

Common issues when using QuillAudits.

| Symptom                                                      | Likely cause                                                                                | What to do                                                                                            |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `Missing X-Org-Id`                                           | JWT session without org header                                                              | Select an org in the UI / send `X-Org-Id`                                                             |
| Audit stuck in `queued`                                      | Job not picked up yet                                                                       | Wait briefly; contact support if it stays queued                                                      |
| `An audit is already running`                                | One full audit per org                                                                      | Wait for the current job to finish or cancel it                                                       |
| Audit failed                                                 | Project could not be analyzed as submitted                                                  | Check the job error in the UI; fix source and start a new audit                                       |
| Checkout / payment required                                  | Cash still due on the order                                                                 | Complete Stripe Checkout, or **Billing** prepaid dollars and retry. Signup credit covers at most 50%. |
| Quote expired                                                | Quote older than about 7 days                                                               | Create a new quote from checkout                                                                      |
| `scope_changed`                                              | Scope edited after an unpaid order                                                          | Save scope, then create a new quote                                                                   |
| Over 40k BLOC                                                | Outside self-serve pricing                                                                  | Contact sales for a custom quote                                                                      |
| Top-up under $0.50                                           | Below Stripe minimum                                                                        | Enter at least **$0.50**                                                                              |
| CI scan HTTP 409                                             | No full-audit baseline ancestor                                                             | Full-audit that branch history (or change the CI base branch)                                         |
| Full audit recommended on a CI scan                          | New `.sol` files, ΔSLOC > 150, or > 5 changed files                                         | The light scan still ran; run a full audit for a new baseline                                         |
| MCP `wallet_topup_required`                                  | Wallet does not cover the quote                                                             | Top up at `/topup`, then confirm                                                                      |
| Ask AI 503                                                   | Platform LLM unavailable                                                                    | Retry later or use Support                                                                            |
| API key rejected                                             | Revoked or wrong org                                                                        | Create a new key in Settings                                                                          |
| Private git clone fails                                      | Missing GitHub App, GitHub, or GitLab connection                                            | Connect GitHub or GitLab.com, or install the GitHub App                                               |
| "The workflow choice changed after this quote was made…"     | The workflow version, its answers or the AI choice changed after the quote                  | Review the updated quote and pay                                                                      |
| "Fill in the required workflow inputs in the Workflow step…" | A required workflow question has no answer                                                  | An owner or admin answers it in the **Workflow** step                                                 |
| Audit **paused**                                             | A custom workflow on your own AI stopped: a plan limit, a sign-out, or a key out of credits | Fix the cause, then **Resume audit** within 7 days, or cancel for a refund                            |
| No workflow assistant in Workflow Studio                     | AI building isn't available on your workspace, or you're not an owner or admin              | Build from an example or from scratch, or ask an owner or admin                                       |
| "Your organization has used this hour's 20 AI requests…"     | The workflow assistant allows 20 AI requests per organization per hour                      | Wait, or keep editing by hand                                                                         |
| A workflow's proofs of concept stay pending                  | The workflow has no build & test access                                                     | An owner or admin clicks **Allow access** on its **How it works** tab                                 |

{% hint style="success" %}
Wallet and receipts live under **Billing**. See Pricing and top-up. CI setup: CI/CD Checks. Workflows: [Troubleshooting workflows](https://www.quillaudits.com/quillshield/guides/reference/troubleshooting-workflows.md). Human help: Expert review and support.
{% endhint %}


---

# 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://www.quillaudits.com/quillshield/guides/reference/troubleshooting.md?ask=<question>&goal=<user_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.
