Glowbeam Cloud Docs

Local test docs for auth, checkout, license lifecycle, and device management.

Auth

Local dev mode uses bearer token format dev-uid:<uid> in the Authorization header.

Primary Flow

Sign in or sign up, then optionally save profile display name via PATCH /v1/me.
Create purchase via POST /v1/billing/checkout_session.
Complete Stripe Checkout and let webhook finalize license state.
Register and assign devices with activate/refresh/release APIs.

Endpoints

GET /v1/me, PATCH /v1/me
GET /v1/licenses, GET /v1/devices
POST /v1/player/devices/register
POST /v1/player/licenses/activate
POST /v1/player/licenses/refresh
POST /v1/player/licenses/release
POST /v1/billing/checkout_session
POST /v1/webhooks/stripe

Notes

All mutating endpoints require Idempotency-Key. The account dashboard auto-generates one per action.

Set GLOWBEAM_CORS_ORIGIN if frontend and API are hosted on different origins.