Troubleshooting

Quick answers for frequent issues.

Import Errors

uv sync
uv run python -c "import vantage_sdk"

Authentication Errors

Ensure your context was created with explicit tokens and settings.

Refresh Errors

If a token refresh fails, confirm that:

• a refresh token was provided
• the refresh token is valid for the selected Vantage environment
• the vantage_url points at the correct environment

Docs Build Errors

cd docusaurus
yarn generate-api-docs

If generation still fails, verify:

• uv is available in the shell used by Docusaurus
• uv run python -c "import vantage_sdk" succeeds from the repo root