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

chalksurf sheet update

chalksurf sheet update [exerciseSheetId]
Apply a field-level patch to an exercise sheet
Positionals:
exerciseSheetId Exercise sheet 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 sheet updated_at ISO timestamp [string] [required]
--patch-json JSON object matching the agent sheet patch contract [string] [required]
Examples:
chalksurf sheet update 00000000-0000-4000-8000-000000000001 --expected-updated-at 2026-01-01T00:00:00.000Z --patch-json '{"translations":{"english":{"name":"Easier variant"}}}' --json Patch sheet metadata with an optimistic updated_at precondition