Skip to content

compozy task block

Block a task with a typed reason

For people running agent work61 pages in this section

compozy task block

Block a task with a typed reason

compozy task block <id> [flags]

Options

      --as-agent            Block using the current Compozy-managed agent session identity
      --details string      Optional block details JSON
      --expires-in string   Optional transient block duration
  -h, --help                help for block
      --kind string         Block kind: needs_input, capability, or transient
      --reason string       Block reason
      --run-id string       Active run ID to park when blocking

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 block <id> -o json

On this page