Skip to main content
The Chamber API provides programmatic access to manage GPU capacity, monitor workloads, and query metrics across your organization.

Base URL

https://api.usechamber.io/v1

Authentication

All API requests (except /v1/health) require authentication using a Bearer token.
curl -X GET "https://api.usechamber.io/v1/workloads" \
  -H "Authorization: Bearer <your-token>" \
  -H "X-Organization-Id: <your-org-id>"

Required Headers

HeaderRequiredDescription
AuthorizationYesBearer token (JWT from Cognito or API token)
X-Organization-IdYes*Your organization ID (*not required for /v1/health)
X-Request-IdNoOptional request ID for tracing
Contact support@usechamber.io to obtain API credentials for your organization.

Response Format

All successful responses follow a consistent structure:
{
  "data": {
    // Response content
  },
  "metadata": {
    "next_token": "...",
    "total_count": 100
  },
  "request_id": "req_abc123"
}

Error Responses

Errors return an appropriate HTTP status code with details:
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid parameter value",
    "details": [...]
  },
  "request_id": "req_abc123"
}

Authorization Model

Access to resources is controlled by your role within the organization:
RoleAccess Level
ORG_ADMINFull organization access
TEAM_LEADTeam-specific access with management capabilities
MEMBERTeam-specific read access

Endpoints

Workloads

List, retrieve, and get statistics for GPU workloads

Metrics

Query GPU utilization, memory, temperature, and power metrics

Capacity

Check budget allocations and remaining GPU hours

Health

Service health check endpoint