Skip to content

compozy automation jobs create

Create an automation job

For people running agent work7 pages in this section

compozy automation jobs create

Create an automation job

compozy automation jobs create [flags]

Options

      --agent string                      Agent definition name; choose either --agent or --loop
      --catch-up-policy string            Catch-up policy for recurring schedules: default, skip_missed, coalesce, replay, or run_once_on_catchup
      --enabled                           Create the job enabled or disabled
  -h, --help                              help for create
      --loop string                       Loop name; choose either --loop or --agent
      --loop-input stringArray            Static Loop input as key=value; repeat for multiple inputs
      --loop-workspace string             Workspace that owns the Loop; required for global automation
      --misfire-grace-seconds int         Missed-fire grace in seconds for recurring schedules; 0 uses the daemon jitter default
      --name string                       Job name
      --network string                    Network participation mode: local or live
      --network-bounds string             JSON object for live participation bounds (one object, not flag explosion)
      --network-channel string            Named channel id when strategy is named
      --network-channel-strategy string   Live channel strategy: named, run, or loop_run
      --prompt string                     Agent prompt body; must be empty for Loop targets
      --retry string                      Retry policy: "none", "backoff", or "backoff:<max_retries>:<base_delay>"
      --schedule string                   Schedule spec: <cron-expr>, every:<duration>, or at:<timestamp>
      --scope string                      Job scope: global or workspace
      --workspace string                  Override workspace binding (ID, name, or path)

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 automation jobs create -o json

On this page