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

# Troubleshooting

> Common issues and how to resolve them.

<AccordionGroup>
  <Accordion title="401 / authentication failed" icon="lock">
    Your session or token expired. Re-authenticate the `autonomy` server in your MCP client (it will reopen the browser login/consent flow).
  </Accordion>

  <Accordion title="410 / stale workspace" icon="rotate">
    The `workspace_id` no longer exists - workspaces can be recycled. Re-run `list_projects` to get a current `workspace_id`, then retry.
  </Accordion>

  <Accordion title="403 on a preview-config tool" icon="ban">
    Full Mode (the `project_cors_proxy` flag) isn't enabled for this project. See [Full Mode](/concepts/full-mode).
  </Accordion>

  <Accordion title="Setup isn't progressing" icon="gear">
    Check `get_setup_preview_status` for the dev-server state, and `list_env_vars` to spot required env vars that aren't set - then fill them with `set_env_var`.
  </Accordion>

  <Accordion title="A task seems stuck" icon="hourglass">
    Tasks run in the background - keep polling `get_task` and report progress rather than blocking. If a run is going the wrong way, `stop_task` cancels it so you can `continue_task` with new guidance.
  </Accordion>

  <Accordion title="A project isn't READY" icon="folder">
    A just-connected repo starts in `PENDING_INITIALIZATION`. Call `initialize_project` and poll `list_projects` until the status is `READY` (that's when it gets a `workspace_id`). If initialization failed, `rerun_initialization` with the job id.
  </Accordion>
</AccordionGroup>

<Tip>
  The product MCP has a built-in guide for this: `load_autonomy_skill name="troubleshooting"`.
</Tip>