Skip to Content
TurboslideDocumentation
Administration in ReferenceContents

Administration

The actions of the admin group, with their input fields and their names on every transport.

6 actions: 6 on the command line, 2 as MCP tools, 6 as HTTP endpoints and 2 in the page.

admin.avatar.sweep

Sweep orphan pictures. Removes picture avatar files under u/ that no profile names and that are older than a day (an upload that never reached its record); by key, never by date or name; refused without an identity database.

FieldTypeRequiredDescription
dryRunbooleannoList the orphans and remove nothing
  • Command line: turboslide admin avatar-sweep --to <to> [--dry-run]
  • MCP tool: No MCP tool.
  • HTTP: POST /api/actions/admin.avatar.sweep
  • Runs on: command line, HTTP.
  • Changes the presentation: yes.

admin.bootstrap

Bootstrap admin. With the static bearer, gives an email the admin role and mints the first API key, shown once.

FieldTypeRequiredDescription
emailstringyes
  • Command line: turboslide admin bootstrap --to <to> --email <email>
  • MCP tool: No MCP tool.
  • HTTP: POST /api/actions/admin.bootstrap
  • Runs on: command line, HTTP.
  • Changes the presentation: yes.

admin.assignOwner

Assign owner. An admin sets a deck’s owner.

FieldTypeRequiredDescription
idstringyes
to{ principalId } | { email }yes
baseRevisionintegeryesThe revision the caller read; a stale value is rejected with 409
  • Command line: turboslide admin assign-owner <id> --email <email>
  • MCP tool: deck_assign_owner
  • HTTP: POST /api/actions/admin.assignOwner
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes; send the baseRevision you read.

admin.flag

Kill switch. Reads or flips one of the kill switches (realtime, presence, comments, invites, email, exports, uploads, renderThumbs, materialize, htmlBlocks, signup, readOnly, assist), read within 5 s by every instance.

FieldTypeRequiredDescription
nameone of 13 valuesyes
onbooleannoAbsent reads the flag
  • Command line: turboslide admin flag <name> --on <on>
  • MCP tool: deck_admin_flag
  • HTTP: POST /api/actions/admin.flag
  • Runs on: command line, MCP, HTTP, page.
  • Changes the presentation: yes.

admin.migrateStorage

Migrate storage. Runs one call of a step of the storage layout v2 migration, one maintenance window per environment (plan, freeze, copy, verify, switch, unfreeze, rekey, rollback or delete), or sweep-produced, which removes the exports and bundles left on the public store before HR-K1#5b, inside a budget; docs/hosting.md section 10.

FieldTypeRequiredDescription
stepone of 10 valuesyes
budgetMsintegernoHow long the call works before it answers; 240 s by default
concurrencyintegernocopy and rollback: the store requests in flight; 32 by default
backupAtstringnodelete only: the ISO time the backup of the private store began, after the switch; delete refuses without one
  • Command line: turboslide admin migrate-storage <step> --to <to> --budget <budget> --concurrency <concurrency> --i-have-a-backup <backupAt>
  • MCP tool: No MCP tool.
  • HTTP: POST /api/actions/admin.migrateStorage
  • Runs on: command line, HTTP.
  • Changes the presentation: yes.

admin.mail.list

Captured mail. The mail captured under TURBOSLIDE_MAIL=capture, newest first; absent otherwise.

FieldTypeRequiredDescription
sincestringno
limitintegerno
  • Command line: turboslide admin mail --to <to> --since <since>
  • MCP tool: No MCP tool.
  • HTTP: POST /api/actions/admin.mail.list
  • Runs on: command line, HTTP.
  • Changes the presentation: no.