Skip to main content

rollbackVoxelUpdates

Reverts every voxel edit made by userId in appId between from and to, returning one RollbackVoxelEventResult per affected voxel (applied tells you whether each was actually changed). DEFAULTS to dryRun=true, which only PREVIEWS the planned reversions without writing; pass dryRun=false to actually apply them (DESTRUCTIVE — mutates world state). A reverted voxel’s edit-log row takes the earlier edit’s type, state and author and the ROLLBACK’s time as its createdAt, so a client reading edits since its last sync sees the revert. When the app’s wilderness is closed (wildernessOpen false), an applied rollback that would write any chunk of closed, unclaimed wilderness is refused (403) before it writes anything; a dry run is not. Requires a valid bearer token AND the manage_apps permission on the org that owns appId (super admins bypass).

rollbackVoxelUpdates(
  input: RollbackVoxelUpdatesInput!
): [RollbackVoxelEventResult!]!

Arguments​

rollbackVoxelUpdates.input ● RollbackVoxelUpdatesInput! non-null input​

Type​

RollbackVoxelEventResult object​

Per-voxel outcome of a rollbackVoxelUpdates call. In dry-run mode this describes what WOULD happen; otherwise it reports what was applied. One result is returned per affected voxel.