chalksurf sheet import

chalksurf sheet import [sources..]

Import one or more exercise sheet sources

Positionals:
  sources  Local file paths, directories, or HTTP(S) URLs  [array] [default: []]

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]
      --manifest       Load sources from a manifest file, or "-" for stdin  [string]
      --relative-path  Override the relative path for a single positional source  [string]
      --single-sheet   Import all positional sources into one sheet  [boolean] [default: false]
      --target-folder  Place a --single-sheet import into this destination folder (defaults to root)  [string]
      --title          Override the imported title for a single-sheet import  [string]
      --translate-to   Generate translated sheet content for these languages (english, hungarian, german, french, spanish, italian)  [array]
      --timeout-ms     Maximum time to wait before timing out  [number] [default: 300000]
      --wait           Wait for the queued jobs to finish  [boolean] [default: false]

Examples:
  chalksurf sheet import ./fixtures/algebra.pdf --title "OKTV 2014 Round 1" --translate-to english --wait                  Import a sheet, override its title, and request an English translation
  chalksurf sheet import ./fixtures/round-1-a.pdf ./fixtures/round-1-b.pdf --single-sheet --target-folder Contests --wait  Import multiple source files into one sheet and place the result into a target folder
  cat sheet-import.json | chalksurf --profile prod-codex sheet import --manifest - --wait --json                           Drive multi-source sheet imports from a manifest in an agent or CI flow

When --wait is set, the command exits after the queued import job reaches a terminal state.
For translated sheet imports, requested translations continue as separate jobs listed in the import result.