Skip to content
Everruns Cloud is open in early access. Run agents without operating the platform.

Durable scheduled tasks and their executions.

CommandWhat it does
durable executions getGet a durable schedule execution.
durable schedules createCreate a new durable scheduled task with a cron expression.
durable schedules deleteDelete a durable schedule.
durable schedules getGet a durable schedule.
durable schedules listList durable scheduled tasks.
durable schedules pausePause a durable schedule.
durable schedules resumeResume a durable schedule.
durable schedules triggerManually trigger a durable schedule.
durable schedules updateUpdate a durable schedule.
durable schedules executions listList executions for a durable schedule.
durable schedules stats getGet durable schedule statistics.

Get a durable schedule execution.

Terminal window
everruns durable executions get [OPTIONS] [EXECUTION_ID]
FlagDescription
--execution-id <EXECUTION_ID>Schedule execution’s identifier.

Example:

Terminal window
# Inspect one run of a schedule, including its error if it failed
everruns durable executions get exec_01h9

Create a new durable scheduled task with a cron expression.

Terminal window
everruns durable schedules create [OPTIONS] --cron-expression <cron_expression> --name <name> --target <target>
FlagDescription
--catch-up-missedWhether to catch up missed triggers (default: false)
--cron-expression <CRON_EXPRESSION>Required. Cron expression (5-field or 7-field).
--description <DESCRIPTION>Optional description.
--enabledWhether schedule is enabled (default: true)
--max-catch-up <MAX_CATCH_UP>Max catch-up executions when catch_up_missed is true.
--max-concurrent <MAX_CONCURRENT>Max concurrent executions.
--name <NAME>Required. Unique name for the schedule.
--retry-policy <RETRY_POLICY>Retry policy for failed executions (provider-specific JSON; see the durable engine’s `RetryPo…
--target <TARGET>Required. Target for a schedule - either a workflow or activity.
--timezone <TIMEZONE>Timezone (default: UTC).

Example:

Terminal window
# Run a session workflow every night
everruns durable schedules create --name nightly-triage --cron-expression '0 2 * * *' --timezone UTC --target '{"type":"workflow","name":"session.run","input":{"session_id":"session_01h9"}}' --reason 'Nightly triage'

Delete a durable schedule.

Terminal window
everruns durable schedules delete [OPTIONS] --schedule-id <schedule_id>
FlagDescription
--schedule-id <SCHEDULE_ID>Required. Schedule’s prefixed public identifier.

Example:

Terminal window
# Remove a schedule you no longer need
everruns durable schedules delete --schedule-id sched_01h9 --reason 'Replaced by a webhook trigger'

Get a durable schedule.

Terminal window
everruns durable schedules get [OPTIONS] [SCHEDULE_ID]
FlagDescription
--schedule-id <SCHEDULE_ID>Schedule’s prefixed public identifier.

Example:

Terminal window
# Check a schedule's cron expression, target and next run
everruns durable schedules get sched_01h9

List durable scheduled tasks.

Terminal window
everruns durable schedules list [OPTIONS]
FlagDescription
--enabledFilter by enabled status.
--limit <LIMIT>Pagination limit (default: 20, max: 100)
--offset <OFFSET>Pagination offset.
--target-type <TARGET_TYPE>Filter by target type (“workflow” or “activity”)

Example:

Terminal window
# Find schedules that are still enabled
everruns durable schedules list --enabled true

Pause a durable schedule.

Terminal window
everruns durable schedules pause [OPTIONS] --schedule-id <schedule_id>
FlagDescription
--schedule-id <SCHEDULE_ID>Required. Schedule’s prefixed public identifier.

Example:

Terminal window
# Stop a schedule from firing while you investigate
everruns durable schedules pause --schedule-id sched_01h9 --reason 'Investigate repeated failures'

Resume a durable schedule.

Terminal window
everruns durable schedules resume [OPTIONS] --schedule-id <schedule_id>
FlagDescription
--schedule-id <SCHEDULE_ID>Required. Schedule’s prefixed public identifier.

Example:

Terminal window
# Turn a paused schedule back on
everruns durable schedules resume --schedule-id sched_01h9 --reason 'Failures fixed'

Manually trigger a durable schedule.

Terminal window
everruns durable schedules trigger [OPTIONS] --schedule-id <schedule_id>
FlagDescription
--schedule-id <SCHEDULE_ID>Required. Schedule’s prefixed public identifier.

Example:

Terminal window
# Run a schedule once now to test its target
everruns durable schedules trigger --schedule-id sched_01h9 --reason 'Verify the target before the next run'

Update a durable schedule.

Terminal window
everruns durable schedules update [OPTIONS] --schedule-id <schedule_id>
FlagDescription
--catch-up-missedCatch up missed triggers.
--cron-expression <CRON_EXPRESSION>New cron expression.
--description <DESCRIPTION>New description.
--enabledEnable/disable.
--max-catch-up <MAX_CATCH_UP>Max catch-up executions.
--max-concurrent <MAX_CONCURRENT>Max concurrent executions.
--retry-policy <RETRY_POLICY>Retry policy (provider-specific JSON; see the durable engine’s RetryPolicy). Example: `{“ma…
--schedule-id <SCHEDULE_ID>Required. Schedule’s prefixed public identifier.
--target <TARGET>
--timezone <TIMEZONE>New timezone (IANA name).

Example:

Terminal window
# Move a schedule to a different time
everruns durable schedules update --schedule-id sched_01h9 --cron-expression '0 3 * * *' --reason 'Avoid the 02:00 backup window'

List executions for a durable schedule.

Terminal window
everruns durable schedules executions list [OPTIONS] --schedule-id <schedule_id>
FlagDescription
--limit <LIMIT>Pagination limit (default: 20, max: 100)
--offset <OFFSET>Pagination offset.
--schedule-id <SCHEDULE_ID>Required. Schedule ID.
--status <STATUS>Filter by execution status.

Example:

Terminal window
# Find recent failed runs of a schedule
everruns durable schedules executions list --schedule-id sched_01h9 --status failed

Get durable schedule statistics.

Terminal window
everruns durable schedules stats get [OPTIONS] --schedule-id <schedule_id>
FlagDescription
--schedule-id <SCHEDULE_ID>Required. Schedule’s prefixed public identifier.

Example:

Terminal window
# See a schedule's success and failure counts
everruns durable schedules stats get --schedule-id sched_01h9