HTTP Endpoints

POST /chat (API Key)

Headers

  • Authorization: Bearer <API_KEY>
  • Content-Type: application/json

Body

  • message (required)
  • context, characterDescription, characterID, playerDescription (optional)

Errors

  • 400 invalid_body
  • 401 invalid/missing api key
  • 402 insufficient_credits
  • 429 rate_limited / too_many_concurrent_requests
  • 500/502 upstream errors

POST /chat/player (Player JWT)

Headers

  • Authorization: Bearer <player JWT>
  • x-nonce, x-ts, x-signature
  • Content-Type: application/json

Body

  • message (required)
  • context, characterDescription, characterID, playerDescription (optional)

Errors

  • 401 invalid_claims / project_not_found / signature_invalid
  • 402 insufficient_credits
  • 429 rate_limited / too_many_concurrent_requests
  • 500/502 upstream errors

POST /session/create

Headers

  • Content-Type: application/json

Body

  • projectId, platform, platformUserId, deviceId, isGuest, steamAuthTicket, refreshTtlDays (optional)

Errors

  • 500 session_create_failed
  • 500 missing_SESSION_CREATE_URL
  • Forwarded upstream errors