Skip to content

compozy task release

Force release claimed task runs back to the queue

For people running agent work61 pages in this section

compozy task release

Force release claimed task runs back to the queue

compozy task release <run-id> [run-id...] [flags]

Examples

  # Release a claim without completing the run
  compozy task release run-123

  # Release multiple claims with shared audit evidence
  compozy task release run-123 run-456 --reason handoff

Options

  -h, --help              help for release
      --metadata string   Optional release metadata JSON
      --reason string     Optional release reason

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 task release <run-id> [run-id...] -o json

On this page