Skip to content
CLI reference for ChalkSurf CLI v0.4.4. Your installed chalksurf --help output remains authoritative for that binary.

chalksurf exercise figure replace

chalksurf exercise figure replace <exerciseId> <exerciseFigureId> [source]
Replace the image with a new figure ID, retaining its display settings and original history
Positionals:
exerciseId Exercise UUID [string] [required]
exerciseFigureId Active figure UUID from exercise get [string] [required]
source Local image path; structured HTTPS/base64/rendered sources use JSON input [string]
Options:
--json Write machine-readable JSON to stdout [boolean] [default: false]
--result-file Publish the complete JSON result envelope to a new private file [string]
--base-url Base URL of the ChalkSurf API [string]
--organization Organization ID to use for this command [string]
--profile CLI profile to use for this command [string]
-v, --version Show the CLI version [boolean]
--help Show help [boolean]
--expected-updated-at Exact updated_at from exercise get; required unless in JSON input [string]
--target-sheet-id Sheet whose use was reviewed [string]
--allow-shared-exercise-update Acknowledge effects on other sheets using this exercise [boolean]
--input Canonical operation JSON from a file or - for stdin; do not combine with edit flags [string]
--input-json Inline canonical operation JSON; do not combine with edit flags [string]
--original-file-name Name retained in image provenance [string]
--allow-needs-revision Explicitly accept a rendered image marked needs_revision [boolean]