Skip to content
Core ConceptsCLI ReferenceAPI Reference
Task
CompozyOS RuntimeTask

compozy task block

Block a task with a typed reason

Audience
Operators running durable agent work
Focus
Task guidance shaped for scanability, day-two clarity, and operator context.

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

Every Compozy command supports -o, --output:

  • human for interactive terminal use
  • json for scripts and other machine-readable consumers
  • jsonl for wait or streaming commands that emit one JSON record per line
  • toon for compact agent-readable summaries

Example:

compozy task block <id> -o json

compozy task approve

Approve a task and enqueue its first run

compozy task blocks

List task blocks

On this page

compozy task blockOptionsOptions inherited from parent commandsOutput Formats