Skip to content
VB-OSVB-OSVB-OS Docs

Troubleshoot VB-OS Authentication Issues

API Key Errors

Section titled “API Key Errors”

401 Unauthorized

Section titled “401 Unauthorized”

The API key is missing, invalid, or expired.

Fix:

  • Verify the Authorization: Bearer <key> header is present
  • Check that the key has not been revoked
  • Ensure the key is scoped to the correct organization and project

403 Forbidden

Section titled “403 Forbidden”

The API key is valid but does not have permission for the requested operation.

Fix:

  • Check the key’s permission scope
  • Verify the key has access to the target project

SDK Authentication

Section titled “SDK Authentication”

Python

Section titled “Python”
from vbos import VBOSClient


client = VBOSClient(api_key="vbos_your_key_here")

Node.js

Section titled “Node.js”
import { VBOSClient } from '@vb-os/sdk';


const client = new VBOSClient({ apiKey: 'vbos_your_key_here' });

Environment Variable

Section titled “Environment Variable”

The CLI reads VBOS_API_KEY from the environment. The SDK library requires api_key as an explicit parameter to VBOSClient.__init__ and does not fall back to environment variables.

Next Steps

Section titled “Next Steps”