Documentation Index
Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt
Use this file to discover all available pages before exploring further.
A Job doesn’t have to be started by hand. The CLI lets you set up three ways for an Assignment to start work on its own: on a recurring schedule, when an external event fires, or when a new Case lands on a Queue.
Schedules
A schedule fires against an Assignment’s live Setup on a recurring cadence — daily, on workdays, weekly, monthly, or a custom cron expression.
duvo agents schedules list <agent-id> # list schedules for an Assignment
Create a schedule
duvo agents schedules create <agent-id> \
--frequency daily \
--timezone America/New_York \
--time 09:00 # every day at 9am New York time
duvo agents schedules create <agent-id> \
--frequency weekly \
--timezone Europe/London \
--day monday \
--time 08:30 # every Monday at 8:30am London time
duvo agents schedules create <agent-id> \
--frequency monthly \
--timezone UTC \
--day-of-month 1 \
--time 06:00 # the 1st of every month at 6am UTC
duvo agents schedules create <agent-id> \
--frequency custom \
--timezone UTC \
--cron "0 */4 * * *" # custom cron: every 4 hours
| Flag | Description |
|---|
--frequency | Required. One of daily, workday, weekly, monthly, or custom |
--timezone | Required. IANA timezone (e.g. America/New_York) |
--time <HH:MM> | Time of day, 24-hour. Required for daily, workday, weekly, monthly |
--day <day> | Day of week for weekly schedules |
--day-of-month <n> | Day of month (1–31) for monthly schedules |
--cron <expr> | Cron expression. Required for custom schedules |
--disabled | Create the schedule paused (default: enabled and running) |
--no-recurring | Retire the schedule after its first run (default: recurring) |
Update or delete a schedule
duvo agents schedules update <agent-id> <schedule-id> --time 10:00 # change the time
duvo agents schedules update <agent-id> <schedule-id> --disable # pause the schedule
duvo agents schedules update <agent-id> <schedule-id> --enable # resume it
duvo agents schedules update <agent-id> <schedule-id> --one-shot # run once, then retire
duvo agents schedules delete <agent-id> <schedule-id> # delete (prompts unless -y)
duvo agents schedules delete <agent-id> <schedule-id> --yes # delete without prompting
update also accepts --timezone, --day, --day-of-month, --cron, and matching --clear-* flags to remove a field. Run duvo agents schedules update --help for the full set.
Case triggers
A Case Trigger connects an Assignment to a Queue so it automatically picks up new Cases as they arrive. For background on the Case Queue system, see Case Queue.
duvo agents case-triggers list <agent-id> # list triggers and their IDs
duvo agents case-triggers get <agent-id> <trigger-id> # show details for one trigger
duvo agents case-triggers create <agent-id> --queue <queue-id> --enabled # create a trigger (omit --enabled to create it disabled)
duvo agents case-triggers update <agent-id> <trigger-id> --enable # enable an existing trigger
duvo agents case-triggers update <agent-id> <trigger-id> --disable # disable an existing trigger
duvo agents case-triggers update <agent-id> <trigger-id> \
--queue <queue-id> # switch the queue the trigger listens to
duvo agents case-triggers update <agent-id> <trigger-id> --concurrency 5 # cap parallel Jobs for this trigger
duvo agents case-triggers update <agent-id> <trigger-id> --clear-concurrency # remove the concurrency cap
duvo agents case-triggers delete <agent-id> <trigger-id> # delete the trigger
duvo agents case-triggers preview <agent-id> --queue <queue-id> # check whether a queue already has an active trigger
Event triggers
An event trigger starts a Job automatically when an external event fires — an email arrives, a Linear issue is created, a file changes in Google Drive, and so on. The Connection must already be set up for the Assignment before you can add a trigger for it.
duvo agents triggers list <agent-id> # list your triggers for an Assignment
duvo agents triggers types <agent-id> # list available trigger types per Connection
duvo agents triggers set <agent-id> \
--integration gmail --trigger-type email_received # create or update a trigger (enabled by default)
duvo agents triggers set <agent-id> \
--integration gmail --trigger-type email_received \
--filter-config '{"from":"boss@acme.com"}' # add an integration-specific filter
duvo agents triggers set <agent-id> \
--integration gmail --trigger-type email_received --disabled # pause a trigger without removing it
set creates the trigger the first time and updates it after that. Use triggers types to discover the --integration and --trigger-type values a Connection supports.
