Skip to main content

GrantAppAccessInput

Input for granting a user access to an app, optionally on a specific tier.

input GrantAppAccessInput {
  appId: BigInt!
  userId: BigInt!
  tierId: BigInt
  grantedBy: String
  idempotencyKey: String
}

Fields​

GrantAppAccessInput.appId ● BigInt! non-null scalar​

Numeric id of the app to grant access to. The caller must hold manage_access_tiers on this app.

GrantAppAccessInput.userId ● BigInt! non-null scalar​

Numeric id of the user who should receive access.

GrantAppAccessInput.tierId ● BigInt scalar​

Optional tier to grant. When omitted, an existing grant keeps its current tier (no tier change).

GrantAppAccessInput.grantedBy ● String scalar​

Optional audit override for who granted access; defaults to the calling user id. Service grants use "system".

GrantAppAccessInput.idempotencyKey ● String scalar​

Optional idempotency key. Recommended for retries: replaying with the same key and identical input returns the first result instead of re-applying; the same key with different input returns IDEMPOTENCY_CONFLICT. Keys expire after 24h.

Member Of​

grantAppAccess mutation