Sessions

Create session tokens scoped to a workspace and user. Session tokens let @assistant-billing/react call the Client API directly from the browser.

Auth: Platform key (sk_pj_*) required.

Create a Session

POST /v1/platform/sessions

Create a session token scoped to a workspace and user. Requires a platform key.

Body Parameters

import { BillingClient } from '@assistant-billing/sdk';
 
const billing = new BillingClient({
  platformKey: process.env.ASSISTANT_BILLING_PLATFORM_KEY,
  workspaceId: 'ws_team_123',
  userId: 'user_456',
});
 
const session = await billing.sessions.create({ expiresIn: 3600 });

Response

{
  "token": "sess_eyJhbGciOiJIUzI1NiJ9...",
  "expires_at": "2025-01-15T13:00:00.000Z"
}

Token Claims

The JWT contains:

{
  "gw": "pj_k8s9d7f6",
  "ws": "ws_team_123",
  "uid": "user_456",
  "iat": 1736938800,
  "exp": 1736942400
}

Use with @assistant-billing/react

import { GatewayClient } from '@assistant-billing/react';
import { BillingClient } from '@assistant-billing/sdk';
 
const client = new BillingClient({
  baseURL: 'https://api.assistant-billing.dev/v1/platform',
  getToken: () => sessionToken,
});
 
<GatewayClient client={client} />

Workspace Registration

The first time a session is created for a workspace_id, the workspace is automatically registered. No explicit workspace creation needed.

Errors