Skip to main content

UpdateAppInput

Input payload for updating an app. All fields are optional; only fields that are provided are changed.

input UpdateAppInput {
  name: String
  description: String
  visibility: AppVisibility
  status: AppStatus
  metadata: String
  wildernessWritesOpen: Boolean
  replayLoggingEnabled: Boolean
  replayLoggingRecordsMedia: Boolean
  replayLoggingRecordsVoice: Boolean
  replayLoggingRecordsVideo: Boolean
  claimOwnerKeys: [String!]
  minPlayerAge: Int
}

Fields​

UpdateAppInput.name ● String scalar​

New display name (1-256 chars). Omit to leave unchanged.

UpdateAppInput.description ● String scalar​

New short description. Omit to leave unchanged.

UpdateAppInput.visibility ● AppVisibility enum​

New visibility (PUBLIC/UNLISTED/PRIVATE). Omit to leave unchanged.

UpdateAppInput.status ● AppStatus enum​

New lifecycle status; set LIVE to publish, or DRAFT/LIVE to restore an archived app. Omit to leave unchanged.

UpdateAppInput.metadata ● String scalar​

New JSON-encoded marketplace metadata string, replacing the existing value (see App.metadata). Omit to leave unchanged.

UpdateAppInput.wildernessWritesOpen ● Boolean scalar​

Open (true) or close (false) the app's wilderness to voxel and chunk writes: chunks that no grid but the app's world grid covers. Closing refuses every write there, whoever makes it; each game API replica, and each realtime server for a client's direct voxel updates, acts on the change within about 15 seconds. Omit to leave unchanged.

UpdateAppInput.replayLoggingEnabled ● Boolean scalar​

Turn replay logging (the safety log) on (true) or off (false): record every client message the realtime servers accept for this app (keep-alives included), kept for the input log's published retention and billed as stored input logs (input_log_storage_byte_hours, no free allowance). Turning it ON is refused with INPUT_LOG_FUNDS_NEEDED unless the org's wallet can spend at least the projected cost of keeping one retention period of the app's recent traffic, or the org is billing-exempt. Turning it off is refused with SAFETY_LOG_REQUIRED while the app admits players under 18 (its minimum player age, or the platform's, is under 18); otherwise it succeeds, and what was already recorded goes on billing until it ages out. Recording starts and stops within about 15 seconds. Omit to leave unchanged.

UpdateAppInput.replayLoggingRecordsMedia ● Boolean scalar​

With replay logging on, record the app's voice (sendAudioPacket), webcam video (sendVideoPacket) and channel audio (sendChannelAudio) too (true, the default) or leave them out of the input log (false); every other message is recorded either way. Takes effect within about 15 seconds; what was already recorded stays until it ages out. Omit to leave unchanged.

UpdateAppInput.replayLoggingRecordsVoice ● Boolean scalar​

With replay logging on, record the app's voice (sendAudioPacket) and channel audio (sendChannelAudio) (true, the default) or leave them out (false). Overrides replayLoggingRecordsMedia for voice when both are given; replayLoggingRecordsMedia then reads true if voice or video is recorded. Omit to leave unchanged.

UpdateAppInput.replayLoggingRecordsVideo ● Boolean scalar​

With replay logging on, record the app's webcam video (sendVideoPacket) (true, the default) or leave it out (false). Overrides replayLoggingRecordsMedia for video when both are given; replayLoggingRecordsMedia then reads true if voice or video is recorded. Omit to leave unchanged.

UpdateAppInput.claimOwnerKeys ● [String!] list scalar​

Grid permission keys a player's claim grants its owner on the claimed grid (at most 8; active grid keys; never a player-code key). An empty list grants none. Applies to claims made from now on. Omit to leave unchanged.

UpdateAppInput.minPlayerAge ● Int scalar​

The youngest age the app admits, 13 to 18. It only ever raises the platform's minimum (18 until players 13 and over are admitted, then 13), never lowers it; younger players are refused AGE_REQUIREMENT_NOT_MET at their next mint or refresh. null returns the app to the platform's minimum. Omit to leave unchanged.

Member Of​

updateApp mutation