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

chalksurf exercise update

chalksurf exercise update [exerciseId]
Apply a field-level patch to an exercise
Positionals:
exerciseId Exercise ID to update [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 Expected current exercise updated_at ISO timestamp [string] [required]
--patch-json JSON object matching the agent exercise patch contract [string] [required]
--target-sheet-id Sheet ID whose variant workflow this update targets [string]
--allow-shared-exercise-update Acknowledge updating an exercise used outside --target-sheet-id [boolean] [default: false]
Examples:
chalksurf exercise update 00000000-0000-4000-8000-000000000001 --expected-updated-at 2026-01-01T00:00:00.000Z --patch-json '{"translations":{"english":{"exercise_text":"Find $x$."}}}' --json Patch exercise content with an optimistic updated_at precondition