Skip to content

compozy session soul refresh

Refresh an idle session's Soul snapshot

For people running agent work2 pages in this section

compozy session soul refresh

Refresh an idle session's Soul snapshot

compozy session soul refresh <session-id> [flags]

Examples

  compozy session soul refresh sess_123 --expected-digest sha256:old --json

Options

      --expected-digest string   Expected current session Soul digest for CAS
  -h, --help                     help for refresh
      --idempotency-key string   Optional idempotency key

Options inherited from parent commands

      --json            Emit JSON output
  -o, --output string   Output format: human, json, jsonl, or toon (default "human")

Output Formats

The root -o, --output flag accepts these values. A renderer is supported only when this command writes that result; jsonl is for commands that emit one JSON record per line.

FormatCommand result
humanInteractive terminal rendering
jsonMachine-readable JSON rendering
jsonlOne JSON record per line when supported
toonCompact agent-readable rendering

Example:

compozy session soul refresh <session-id> -o json

On this page