Authentication - Chamber

The Chamber SDK supports multiple authentication methods. Choose the one that best fits your workflow.

Authentication Methods

Set the CHAMBER_TOKEN environment variable:

export CHAMBER_TOKEN="ch.your-api-token"

Then initialize the client without arguments:

from chamber_sdk import ChamberClient

client = ChamberClient()

If you have the Chamber CLI installed and authenticated, the SDK can use its credentials:

from chamber_sdk import ChamberClient

client = ChamberClient.from_config()

This reads from ~/.chamber/token.json.

Pass the token directly to the client:

from chamber_sdk import ChamberClient

client = ChamberClient(token="ch.your-api-token")

Avoid hardcoding tokens in source code. Use environment variables or secret management for production.

API tokens start with the prefix ch. followed by a unique identifier.

If you belong to multiple organizations, specify which one to use:

client = ChamberClient(
    token="ch.your-api-token",
    organization_id="org-123456"
)

Parameter	Description	Default
`token`	API token	From env or config
`organization_id`	Organization ID for multi-org users	None
`api_url`	Override API endpoint	`https://api.usechamber.io/v1`
`timeout`	Request timeout in seconds	30

For testing or custom deployments, you can override the default API URL:

client = ChamberClient(
    token="ch.your-api-token",
    api_url="https://custom.api.example.com/v1"
)

The default API endpoint is https://api.usechamber.io/v1.

Test your credentials by checking the API health:

client = ChamberClient()
health = client.health()
print(f"API Status: {health.status}")
print(f"API Version: {health.version}")

The SDK looks for authentication tokens in this order:

If no token is found, an AuthenticationError is raised.

With authentication configured, follow the Quickstart guide to submit your first workload.