Skip to content
Developer Hub

Open app

Create a demo session

POST
/demo-sessions

Launch a demo game session. No real-money wallet involvement; no bet or win callbacks emitted. Useful for sandbox testing or prospect-facing free-play surfaces. Demo sessions are non-financial and do not require an Idempotency-Key header.

Mobule requires current support approval for the exact organization bound to the authenticated operator key. Unbound keys cannot infer an organization. A platform key takes no sub_operator_ref here and is evaluated as the platform account, admitted by its organization’s approval. Discovery omits unapproved games (direct game/stakes lookup returns 404). Launches and launcher re-reads return PROVIDER_ACCESS_REQUIRED (403) on denial; storage uncertainty returns PROVIDER_ACCESS_UNAVAILABLE (503). Requests for other providers keep their existing access policy.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
object
game_id
required
string format: uuid

Responses

Section titled “Responses”

201

Section titled “201”

Demo session created.

object
session_id
required
string format: uuid
game_url
required

One-time-use signed URL the player is redirected to.

string format: uri
provider_session_uid
string
provider_code
required
string

401

Section titled “401”

Missing, invalid, or revoked API key.

object
error
required
object
code
required

Machine-parseable error code. See https://hub.aggregator.gg/error-reference/.

string
/^(E[0-9A-F][0-9]{3}|PROVIDER_ACCESS_REQUIRED|PROVIDER_ACCESS_UNAVAILABLE)$/
E0001
message
required
string
request_id

Correlation ID for support escalation.

string
details
object
key
additional properties
any

403

Section titled “403”

The game’s provider is not available to operators - it has not completed go-live, or the platform suspended it (E1003). Mobule additionally requires current approval (PROVIDER_ACCESS_REQUIRED).

object
error
required
object
code
required

Machine-parseable error code. See https://hub.aggregator.gg/error-reference/.

string
/^(E[0-9A-F][0-9]{3}|PROVIDER_ACCESS_REQUIRED|PROVIDER_ACCESS_UNAVAILABLE)$/
E0001
message
required
string
request_id

Correlation ID for support escalation.

string
details
object
key
additional properties
any

404

Section titled “404”

Game not found or does not support demo mode.

object
error
required
object
code
required

Machine-parseable error code. See https://hub.aggregator.gg/error-reference/.

string
/^(E[0-9A-F][0-9]{3}|PROVIDER_ACCESS_REQUIRED|PROVIDER_ACCESS_UNAVAILABLE)$/
E0001
message
required
string
request_id

Correlation ID for support escalation.

string
details
object
key
additional properties
any

503

Section titled “503”

Provider access or session authorization storage is temporarily unavailable.

object
error
required
object
code
required

Machine-parseable error code. See https://hub.aggregator.gg/error-reference/.

string
/^(E[0-9A-F][0-9]{3}|PROVIDER_ACCESS_REQUIRED|PROVIDER_ACCESS_UNAVAILABLE)$/
E0001
message
required
string
request_id

Correlation ID for support escalation.

string
details
object
key
additional properties
any