> For the complete documentation index, see [llms.txt](https://kb.packfiles.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.packfiles.io/using-warp/support/troubleshooting/failed-inventory-scan.md).

# Failed Inventory Scan

An inventory scan is how Warp discovers repositories in your source platform. When you run a scan, Warp's Runner Agent connects to your source (Azure DevOps, Bitbucket Server, etc.) using the credentials stored in your vault and retrieves a list of repositories. This page covers the reasons an inventory scan can fail and how to resolve them.

## Symptoms

* Scan action fails in the Actions tab of Migration HQ.
* Scan completes but no repositories appear in the Issues tab.
* Error messages in runner logs referencing authentication or authorization.

## Common Causes and Solutions

### Insufficient Permissions

The personal access token (PAT) stored in your vault may not have the scopes required to read repositories from your source platform.

**Resolution:**

1. Verify the PAT has the required scopes for your source platform. Refer to the [Set Up Your Vault](/guides/quickstart/set-up-your-vault.md) guide for the specific scopes needed.
2. If the scopes are incorrect, generate a new PAT with the correct permissions.
3. Update the credential in the Warp Vault app and push the updated vault file to Migration HQ.

### Expired Personal Access Token

Personal access tokens have expiration dates. An expired PAT will cause authentication failures during the scan.

**Resolution:**

1. Check the expiration date of the PAT on your source platform.
2. Generate a new PAT with the same scopes.
3. Update the credential in the [Warp Vault](/using-warp/warp-vault.md) app and push the updated vault file to Migration HQ.

### Outdated Vault File

If credentials were updated outside of Warp Vault, or a new vault was generated but not pushed to Migration HQ, the vault file may be stale.

**Resolution:**

1. Open the [Warp Vault](/using-warp/warp-vault.md) app and verify your credentials are current.
2. Re-export the vault file.
3. Push the updated `vault.age` file to Migration HQ.

### GitHub Outage

If GitHub is experiencing an outage, Runner Agents cannot execute workflows, and scans will fail.

**Resolution:**

1. Check [GitHub Status](https://www.githubstatus.com/) for any ongoing incidents.
2. Wait for the incident to be resolved, then retry the scan.

## Checking Runner Logs

Runner Agent logs provide detailed error information that can help identify the root cause. See [Troubleshooting Using a Runner Agent's Logs](/using-warp/migration-hq/runner-agent.md) for instructions on locating and reading log output.

## Related Pages

* [Failed Migration](/using-warp/support/troubleshooting/failed-migration.md) — similar causes apply to migration failures
* [Troubleshooting](/using-warp/support/troubleshooting.md) — index of all common issues
* [Support](/using-warp/support.md) — contact Product Support


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://kb.packfiles.io/using-warp/support/troubleshooting/failed-inventory-scan.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.