Session Token API

The Spatius Console API runs at the host below. Most users do not need to call it directly — the SDKs and livekit-plugins-spatius compose endpoint URLs from SPATIUS_REGION automatically. Call this API from your backend when you need to mint short-lived Session Tokens for Direct Mode clients.

Region	Console API host
`us-west` (default)	`console.us-west.spatius.ai`
`ap-northeast`	`console.ap-northeast.spatius.ai`
`cn-beijing`	`console.cn-beijing.spatialwalk.top`

See Regions for the full endpoint reference and override options.

Obtain a session token

Call the endpoint POST /v1/console/session-tokens on your console host.

Request parameters

Body
- appId: string, your Spatius App ID
- expireAt: int, expiration timestamp in seconds. Range: now < expire_at < now + 24 hours
Header
- X-Api-Key: your API key

Request example

curl --location --request POST 'https://console.us-west.spatius.ai/v1/console/session-tokens' \
  --header 'X-Api-Key: <your-api-key>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "appId": "<your-app-id>",
    "expireAt": 1754824283
  }'

Response example

The response shape returns the token under one of sessionToken, sessionKey, or token, optionally wrapped in a data object. Reference implementations extract whichever field is present; see the Session Token server examples in the demo repository.

{
  "sessionToken": "..."
}

Reference Overview

Client SDKs

Server SDKs