Skip to main content

AppUserAccess

A user's entitlement to a specific app: whether (and via which tier) they may access it. At most one row per (app, user).

type AppUserAccess {
appUserAccessId: BigInt!
appId: BigInt!
userId: BigInt!
tierId: BigInt
status: String!
grantedBy: String!
subscriptionId: String
expiresAt: DateTime
createdAt: DateTime!
updatedAt: DateTime!
user: User
tier: AppAccessTier
}

Fields

AppUserAccess.appUserAccessId ● BigInt! non-null scalar

Unique numeric id of this access record (primary key).

AppUserAccess.appId ● BigInt! non-null scalar

Numeric id of the app this access applies to.

AppUserAccess.userId ● BigInt! non-null scalar

Numeric id of the user this access belongs to.

AppUserAccess.tierId ● BigInt scalar

Numeric id of the access tier granting this access; null if access was granted without a specific tier.

AppUserAccess.status ● String! non-null scalar

Entitlement lifecycle: "active" (currently entitled) or "revoked" (access removed). Only active, non-expired rows grant runtime access. Defaults to "active".

AppUserAccess.grantedBy ● String! non-null scalar

Who granted this access: the granting admin's numeric user id (as a string), or "system" for automatic/free-tier grants.

AppUserAccess.subscriptionId ● String scalar

External billing subscription id (e.g. Stripe/PayPal) backing a paid grant; null for free or manual grants.

AppUserAccess.expiresAt ● DateTime scalar

Optional expiry timestamp; access is treated as inactive once it has passed. Null means the grant does not expire.

AppUserAccess.createdAt ● DateTime! non-null scalar

Timestamp when the access record was first created.

AppUserAccess.updatedAt ● DateTime! non-null scalar

Timestamp when the access record was last updated (e.g. re-granted or revoked).

AppUserAccess.user ● User object

The user this access record belongs to. Null if the user could not be loaded.

AppUserAccess.tier ● AppAccessTier object

The access tier granted by this record. Null if no tier is associated (tierId is null) or the tier could not be loaded.

Returned By

appUserAccessByApp query ● claimFreeAppAccess mutation ● grantAppAccess mutation ● grantMyAppAccess mutation ● myAppAccess query ● revokeAppAccess mutation

Member Of

AppUserAccessEdge object