@go-labs-sg/gosh 0.1.0

package/command-reference.md

@@ -0,0 +1,1059 @@
+# GOSH CLI command reference
+
+Generated from the command registry. Commands with JSON input pass the exact object to the corresponding tRPC procedure.
+
+## `gosh health status`
+
+Check whether the GOSH API is healthy.
+
+- Authentication: not required
+- Input: none
+- Effects: read-only
+
+## `gosh auth whoami`
+
+Return the user represented by the active browser-authenticated CLI session.
+
+- Authentication: browser-authenticated CLI session required
+- Input: none
+- Effects: read-only
+
+## `gosh organization list`
+
+List organizations available to the current user.
+
+- Authentication: browser-authenticated CLI session required
+- Input: none
+- Effects: read-only
+
+## `gosh organization get`
+
+Get one organization by ID or slug.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh organization members`
+
+List an organization's members and pending invitations.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event list`
+
+List active events in an organization.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event get`
+
+Get an event by ID or slug.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event setup`
+
+Get the organizer setup view for an event.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event participants`
+
+Get the organizer participant view for an event.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event stations`
+
+Get the organizer station workspace for an event.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event teams`
+
+Get the organizer teams view for an event.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event submissions`
+
+List submissions awaiting or completing review.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event submissions request-image-export`
+
+Queue a photo-and-video submission ZIP and email its download link when ready.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, email, external-write
+
+## `gosh event submissions image-exports`
+
+List submission media exports requested by the current user.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event submissions get-image-export-download`
+
+Get the download link for a completed submission media export.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event analytics`
+
+List event completion analytics.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event activity`
+
+List an event's activity timeline.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event broadcasts`
+
+List live-operations broadcasts for an event.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event rewards`
+
+List rewards configured for an event.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event score-adjustments`
+
+List score adjustments for an event.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event versions`
+
+List saved versions of an event.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event results-export`
+
+Return event results in a machine-readable export shape.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event create`
+
+Create an event.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh event create-from-template`
+
+Create an event from a template.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh event update`
+
+Update event details.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh event update-status`
+
+Change an event's lifecycle status.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh event add-participant`
+
+Add one participant to an event.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, email, external-write
+
+## `gosh event add-participants`
+
+Add multiple participants to an event.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, email, external-write
+
+## `gosh event delete-participants`
+
+Delete participants from an event.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, delete
+
+## `gosh event send-participant-magic-link`
+
+Send one participant login link.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, email, external-write
+
+## `gosh event send-participant-magic-links`
+
+Send participant login links in bulk.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, email, external-write
+
+## `gosh event upsert-collaborator`
+
+Create or update an event collaborator.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh event remove-collaborator`
+
+Remove an event collaborator.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, delete
+
+## `gosh event create-version`
+
+Save an event version snapshot.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh event rollback-version`
+
+Roll an event back to a saved version.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh station create`
+
+Create a station in an event.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh station update`
+
+Update a station.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh station clone`
+
+Clone a station and its missions.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh station archive`
+
+Archive a station.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, delete
+
+## `gosh station reorder`
+
+Reorder an event's stations.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh mission create`
+
+Create a mission in a station.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh mission update`
+
+Update a mission.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh mission archive`
+
+Archive a mission.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, delete
+
+## `gosh mission reorder`
+
+Reorder missions within a station.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh team list`
+
+List teams and their current members.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh team create`
+
+Create a team.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh team update`
+
+Update a team.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh team assign-member`
+
+Assign an event player to a team.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh team remove-member`
+
+Remove a member from a team.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, delete
+
+## `gosh team set-play-mode`
+
+Change an event between individual and team play.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh team set-submission-access`
+
+Change who can submit missions in team play.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh template list`
+
+List system and organization templates.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh template get`
+
+Get a template by ID.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh template create`
+
+Create an organization template.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh template update`
+
+Replace a template's setup.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh template update-metadata`
+
+Update template metadata.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh template delete`
+
+Delete a template.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, delete
+
+## `gosh broadcast create`
+
+Create or schedule an event broadcast.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, external-write
+
+## `gosh broadcast cancel`
+
+Cancel a scheduled broadcast.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh broadcast delete`
+
+Delete a broadcast.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, delete
+
+## `gosh broadcast deliver-due`
+
+Deliver broadcasts that are due now.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, external-write
+
+## `gosh reward create`
+
+Create an event reward.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh reward update`
+
+Update an event reward.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh score adjust`
+
+Create a manual score adjustment.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh submission review`
+
+Review a mission submission.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh results-share regenerate`
+
+Create a new results portal share token.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh results-share revoke`
+
+Revoke the current results portal share token.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, delete
+
+## `gosh event analytics-shell`
+
+Get the organizer analytics shell.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event collaborators`
+
+Get event collaborators and access details.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event header`
+
+Get the organizer event header.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event launch`
+
+Get event launch readiness and state.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event leaderboard`
+
+Get the staff leaderboard.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh mission shell`
+
+Get mission editor data.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event participant-import`
+
+Get participant import context.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event preview`
+
+Get the organizer event preview.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh station create-context`
+
+Get station creation context.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh station editor`
+
+Get station editor data.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh submission filters`
+
+Get submission review filter values.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh results-share get`
+
+Get the current results portal share.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh event update-access`
+
+Update event access rules.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh event update-branding`
+
+Update event branding.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh station update-availability`
+
+Update station availability.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh station update-image`
+
+Update a station image.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh station update-location`
+
+Update station location and geofence settings.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh event save-as-template`
+
+Save an event as a template.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh player event`
+
+Get the current player's event details.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh player leaderboard page`
+
+Get a page of the player leaderboard.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh player leaderboard`
+
+Get the current player leaderboard.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh player map`
+
+Get the player event map.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh player shell`
+
+Get the player application shell.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh player station`
+
+Get a playable station.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh player events`
+
+List events joined by the current user.
+
+- Authentication: browser-authenticated CLI session required
+- Input: none
+- Effects: read-only
+
+## `gosh player broadcasts`
+
+List broadcasts visible to the current player.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh player broadcast`
+
+Get one broadcast visible to the current player.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh player rewards`
+
+List rewards visible to the current player.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh player join`
+
+Join an event as the current user.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh player team join`
+
+Join an event team.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh player broadcasts mark-read`
+
+Mark player broadcasts as read.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh player review`
+
+Submit an event review.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh player display-name update`
+
+Update the player's display name.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh player resolve-join-code`
+
+Resolve an event or team join code.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh player station-check-in`
+
+Create an expiring station check-in proof.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh player mission submit`
+
+Submit a mission response.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh public event-login`
+
+Get public event login details.
+
+- Authentication: not required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh public results`
+
+Get a shared public results portal.
+
+- Authentication: not required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh public request-login-code`
+
+Send an event login email code.
+
+- Authentication: not required
+- Input: `--input '<json>'` required
+- Effects: email, external-write
+
+## `gosh upload branding`
+
+Upload an event branding asset from a local file.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, external-write
+
+## `gosh upload setup-image`
+
+Upload a station or mission setup image from a local file.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, external-write
+
+## `gosh upload profile-image`
+
+Upload a profile image from a local file.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, external-write
+
+## `gosh player mission upload`
+
+Upload mission media from a local file, including multipart video.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, external-write
+
+## `gosh player mission upload-complete`
+
+Complete a low-level multipart mission upload.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, external-write
+
+## `gosh player mission upload-abort`
+
+Abort a low-level multipart mission upload.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, delete, external-write
+
+## `gosh player watch`
+
+Watch player event changes as newline-delimited JSON.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh submission watch`
+
+Watch submission review queue changes as newline-delimited JSON.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh organization create`
+
+Create an organization.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh organization update`
+
+Update an organization.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh organization slug-check`
+
+Check whether an organization slug is available.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh organization access-check`
+
+Check access to an organization.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh organization onboarding`
+
+Get the current user's organization onboarding state.
+
+- Authentication: browser-authenticated CLI session required
+- Input: none
+- Effects: read-only
+
+## `gosh organization invitation get`
+
+Get an invitation addressed to the current user.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh organization invitation accept`
+
+Accept an organization invitation.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh organization invitation reject`
+
+Reject an organization invitation.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, delete
+
+## `gosh organization invitation cancel`
+
+Cancel an organization invitation.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, delete
+
+## `gosh organization member invite`
+
+Invite an organization member.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, email, external-write
+
+## `gosh organization member remove`
+
+Remove an organization member.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, delete
+
+## `gosh organization member role-update`
+
+Update an organization member role.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh organization list-all`
+
+List every organization as a global admin.
+
+- Authentication: browser-authenticated CLI session required
+- Input: none
+- Effects: read-only
+
+## `gosh template system-create`
+
+Create a system template as a global admin.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh admin users list`
+
+List and search users as a global admin.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh admin users role-update`
+
+Update a user's global role.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh admin users ban`
+
+Ban a user and revoke their sessions and API keys.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, delete
+
+## `gosh admin users unban`
+
+Unban a user.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change