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
      --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: user (aliases: @user, 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")
      --profile string   Act as a profile for this command

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