Skip to main content

AppAccessTier

A free or purchasable access tier for an app, bundling a price and the set of runtime permission keys that granted users receive.

type AppAccessTier {
  tierId: BigInt!
  appId: BigInt!
  name: String!
  tierOrder: Float!
  isFree: Boolean!
  isDefault: Boolean!
  priceCents: BigInt
  currency: String
  billingPeriod: String
  description: String
  permissionKeys: [String!]!
  status: String!
  createdAt: DateTime!
  updatedAt: DateTime!
}

Fields​

AppAccessTier.tierId ● BigInt! non-null scalar​

Unique numeric id of the tier (primary key).

AppAccessTier.appId ● BigInt! non-null scalar​

Numeric id of the app this tier belongs to.

AppAccessTier.name ● String! non-null scalar​

Display name of the tier (e.g. "Free", "Pro").

AppAccessTier.tierOrder ● Float! non-null scalar​

Sort order for displaying tiers (ascending); lower values appear first.

AppAccessTier.isFree ● Boolean! non-null scalar​

True if the tier has no purchase cost.

AppAccessTier.isDefault ● Boolean! non-null scalar​

True if this is the app default tier (used for open-by-default / self-service grants). At most one default per app is expected.

AppAccessTier.priceCents ● BigInt scalar​

Price in the smallest currency unit (cents) for paid tiers; null for free tiers.

AppAccessTier.currency ● String scalar​

ISO 4217 currency code for priceCents (e.g. "usd"); defaults to "usd".

AppAccessTier.billingPeriod ● String scalar​

Billing cadence for recurring tiers (e.g. "month", "year"); null for one-time or free tiers.

AppAccessTier.description ● String scalar​

Optional marketing description of what the tier includes.

AppAccessTier.permissionKeys ● [String!]! non-null scalar​

Runtime permission keys granted to users on this tier (a subset of runtimePermissions), e.g. "access", "teleport", "update_voxel_data", "use_voice_chat".

AppAccessTier.status ● String! non-null scalar​

Tier lifecycle: "active" or "archived" (soft-deleted via archiveAccessTier). Defaults to "active".

AppAccessTier.createdAt ● DateTime! non-null scalar​

Timestamp when the tier was created.

AppAccessTier.updatedAt ● DateTime! non-null scalar​

Timestamp when the tier was last updated.

Returned By​

appAccessTiers query ● archiveAccessTier mutation ● createAccessTier mutation ● updateAccessTier mutation

Member Of​

AppUserAccess object