compozy task fail
Fail task runs through a session-bound lease or operator override
compozy task fail
Fail task runs through a session-bound lease or operator override
compozy task fail <run-id> [run-id...] [flags]Examples
# Fail the current session's claimed run
compozy task fail run-123 --error "provider returned invalid JSON"
# Force fail one run
compozy task fail run-123 --reason "operator recovery"
# Force fail multiple runs with shared audit evidence
compozy task fail run-123 run-456 \
--reason "provider credentials revoked" \
--metadata '{"incident":"INC-42"}'Options
--error string Session-bound failure message
-h, --help help for fail
--metadata string Optional failure metadata JSON
--reason string Forced-failure reasonOptions 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.
| Format | Command result |
|---|---|
human | Interactive terminal rendering |
json | Machine-readable JSON rendering |
jsonl | One JSON record per line when supported |
toon | Compact agent-readable rendering |
Example:
compozy task fail <run-id> [run-id...] -o json