artifacts:upload:prepare

Create upload batch with signed per-item upload tickets.

Reference for flywheel artifacts:upload:prepare.

Command Group

Artifacts & Files Commands

Summary

Create upload batch with signed per-item upload tickets.

Usage

flywheel artifacts:upload:prepare <FLAGS>

Required flags

FlagValueDefaultChoicesDescription
--node_idstringOwning node.
--expected_revisionintegerOptimistic lock.
--itemsjsonJSON array of upload items.

Optional flags

FlagValueDefaultChoicesDescription
--formatFORMATjson, tsv, csv, tableOutput format for command results.
--envPROFILEUse a configured CLI profile for this invocation.
--outPATHWrite output to a file path, or use - for stdout.
--openOpen browser-bound URLs when supported.
--no-retryDisable transient-error retries.
--retry-maxNMaximum transient-error retry attempts.
--waitBlock on async operations until a terminal state is reached.
--wait-timeoutSECONDS600Seconds to wait for --wait before timing out. Defaults to 600.
--allow-selfAllow mutating the currently active credential.
--timeoutSECONDSSet the per-request timeout budget in seconds.
--idempotency-keyKEYReuse an Idempotency-Key so ambiguous write failures can be retried with the same key.
--forceForce safety-gated operations where supported.
--yesSkip confirmation prompts for destructive operations.
--debugPrint structured request debugging with secrets masked.
--verbosePrint verbose progress for long-running operations.
-h, --helpShow this help.

Examples

Prepare one upload.

flywheel artifacts:upload:prepare --node_id n --expected_revision 3 --items '[{"local_path":"report.pdf"}]'