An application is the top-level product container in the Platform.

Applications

An application is one product that uses the Platform API and SDKs.

Fields (conceptual)

FieldRole
codeStable string id used by SDKs (YOUR_APP_CODE)
nameHuman label in admin
statusOnly active apps are served on public endpoints
Public keyrb_pub_… required for paywall and payments
Payments flagEnables paid checkout for the app

Client identification

Every SDK request should identify the app via:

  • Header X-Application-Code: YOUR_APP_CODE (default), or
  • Header X-Application-Id: <uuid> when you prefer UUID

Plus, when required:

  • X-Public-Key: YOUR_PUBLIC_KEY
  • Authorization: Bearer YOUR_ACCESS_TOKEN for user-scoped routes

What lives under an application

  • Entitlements
  • Plans / prices
  • Paywalls
  • Users (memberships)
  • Devices
  • Payments / subscriptions
  • Remote config & feature flags
  • Analytics events