Get the sandbox's simulation settings
get/v1/test_helpers/simulation
Whether background (ambient) plays are on, until when, and how often each screen plays.
Access
- Authentication
- Secret key or OAuth access token.
- Scope
test_helpers:write- User permission
developerAccess
Headers
Vojo-VersionstringOptional API version pin (a date). Overrides the version pinned on the secret key / organisation for this request. Echoed in the
Vojo-Versionresponse header. Within/v1only additive changes ship, so most callers can omit it.
Response 200
OK
dataobjectRequiredShow 6 fields
ambientbooleanRequiredambient_untilstring or nullRequiredWhen ambient plays switch themselves off; null while off.
plays_per_hourintegerRequiredRoughly how often each simulated screen plays while ambient is on.
plays_todayintegerRequiredSimulated plays started today (Europe/London), test plays included.
plays_per_day_limitintegerRequiredlivemodebooleanFalse for an object in an integrator sandbox (test key), true otherwise. Always set on each object directly under
data; absent on the same kind of object nested inside another.
metaobjectRequired
Response headers
Vojo-VersionstringThe API version (date) this response was rendered with — the request's
Vojo-Version, else the key/org pin.RateLimitstringIETF RateLimit header: remaining quota in the current window, e.g.
"default";r=97;t=42.RateLimit-PolicystringIETF RateLimit-Policy header, e.g.
"default";q=100;w=60. Portal OAuth clients get a higher tier.
Errors
Every error is application/problem+json. Branch on its code.
- 401
Missing, invalid, expired or revoked credential.
- 403
The caller is authenticated but not allowed: missing scope (
insufficient_scope), missing Permissions flag (permission_denied), a client/installer persona on an operator endpoint (operator_access_required), or no access to the requested org (organisation_access_denied). - 429
Rate limit exceeded for this principal. Back off for
Retry-Afterseconds. - 500
Unexpected server failure.