Skip to content

Public platform app configuration feed for Roku and future TV/mobile clients.

REST API — App Config

Platform-specific behavior, branding, layout, and feature visibility for connected apps.

Endpoint

GET /wp-json/mediablaster/v3/config?platform=roku
PropertyValue
AuthNone (public)
MethodGET
Query platformDefault roku; currently only roku is supported

Discovery index includes links.config pointing to this URL.

What this endpoint is (and is not)

Is:

  • Remote source of truth for user-configurable app settings managed under MediaBlaster → App Config
  • Branding colors, labels, navigation feature flags, home layout, boot behavior, and similar client settings

Is not:

  • API discovery — the client must already know the WordPress base URL
  • Subscription or Stripe configuration — use GET /app/config instead (requires subscriptions REST enabled)
  • A place for secrets — never include API keys, tokens, or apiBaseUrl / apiOrigin

Query parameters

ParamDefaultDescription
platformrokuPlatform slug (roku only in v1)

Invalid platform:

{
  "code": "mediablaster_invalid_platform",
  "message": "Unsupported platform.",
  "data": { "status": 400 }
}

Response overview (Roku)

Top-level fields include:

FieldDescription
platformroku
schemaVersionConfig schema version (e.g. 1.0)
appNameDisplay name
debugModeDiagnostic logging toggle
enableSubscriptionsApp-level subscriptions UI toggle
enableVod, enableMovies, enableSeries, …Content availability flags
brandColor, accentOrange, …Branding colors (hex)
heroFallbackImage, posterFallbackImageRoku asset paths
supportUrl, privacyUrlPublic legal/help links
sidebarEnabledSidebar visibility
featuresNavigation destination flags (home, movies, series, …)
labelsCustom UI strings
layoutHome screen layout flags
sidebarexpandedWidth, collapsedWidth
homeTagRowsTag row settings
homeRowsAlways [] in v1
bootrequireDiscovery, loadFeaturedOnStart
meta.generatedAtISO 8601 timestamp (UTC)

Values merge saved WordPress options over plugin defaults. Unsaved installs still return sensible defaults.

Admin configuration

Manage values at MediaBlaster → App Config → App Settings. See App Config.

Option key: mediablaster_app_config

Compare with /app/config

RoutePurposeAuthRequires subscriptions
GET /config?platform=rokuPlatform app UI/behavior configPublicNo
GET /app/configStripe keys, tiers, auth flagsPublic when REST onYes (+ REST enabled)

Verification

Open /wp-json/mediablaster/v3/config?platform=roku in a browser to confirm the endpoint returns your saved settings.

Was this helpful?