everruns durable
Applies toFramework (not available)Self-hostedEverruns Cloud
Durable scheduled tasks and their executions.
| Command | What it does |
|---|---|
durable executions get | Get a durable schedule execution. |
durable schedules create | Create a new durable scheduled task with a cron expression. |
durable schedules delete | Delete a durable schedule. |
durable schedules get | Get a durable schedule. |
durable schedules list | List durable scheduled tasks. |
durable schedules pause | Pause a durable schedule. |
durable schedules resume | Resume a durable schedule. |
durable schedules trigger | Manually trigger a durable schedule. |
durable schedules update | Update a durable schedule. |
durable schedules executions list | List executions for a durable schedule. |
durable schedules stats get | Get durable schedule statistics. |
durable executions get
Section titled “durable executions get”Get a durable schedule execution.
everruns durable executions get [OPTIONS] [EXECUTION_ID]| Flag | Description |
|---|---|
--execution-id <EXECUTION_ID> | Schedule execution’s identifier. |
Example:
# Inspect one run of a schedule, including its error if it failedeverruns durable executions get exec_01h9durable schedules create
Section titled “durable schedules create”Create a new durable scheduled task with a cron expression.
everruns durable schedules create [OPTIONS] --cron-expression <cron_expression> --name <name> --target <target>| Flag | Description |
|---|---|
--catch-up-missed | Whether to catch up missed triggers (default: false) |
--cron-expression <CRON_EXPRESSION> | Required. Cron expression (5-field or 7-field). |
--description <DESCRIPTION> | Optional description. |
--enabled | Whether 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:
# Run a session workflow every nighteverruns 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'durable schedules delete
Section titled “durable schedules delete”Delete a durable schedule.
everruns durable schedules delete [OPTIONS] --schedule-id <schedule_id>| Flag | Description |
|---|---|
--schedule-id <SCHEDULE_ID> | Required. Schedule’s prefixed public identifier. |
Example:
# Remove a schedule you no longer needeverruns durable schedules delete --schedule-id sched_01h9 --reason 'Replaced by a webhook trigger'durable schedules get
Section titled “durable schedules get”Get a durable schedule.
everruns durable schedules get [OPTIONS] [SCHEDULE_ID]| Flag | Description |
|---|---|
--schedule-id <SCHEDULE_ID> | Schedule’s prefixed public identifier. |
Example:
# Check a schedule's cron expression, target and next runeverruns durable schedules get sched_01h9durable schedules list
Section titled “durable schedules list”List durable scheduled tasks.
everruns durable schedules list [OPTIONS]| Flag | Description |
|---|---|
--enabled | Filter 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:
# Find schedules that are still enabledeverruns durable schedules list --enabled truedurable schedules pause
Section titled “durable schedules pause”Pause a durable schedule.
everruns durable schedules pause [OPTIONS] --schedule-id <schedule_id>| Flag | Description |
|---|---|
--schedule-id <SCHEDULE_ID> | Required. Schedule’s prefixed public identifier. |
Example:
# Stop a schedule from firing while you investigateeverruns durable schedules pause --schedule-id sched_01h9 --reason 'Investigate repeated failures'durable schedules resume
Section titled “durable schedules resume”Resume a durable schedule.
everruns durable schedules resume [OPTIONS] --schedule-id <schedule_id>| Flag | Description |
|---|---|
--schedule-id <SCHEDULE_ID> | Required. Schedule’s prefixed public identifier. |
Example:
# Turn a paused schedule back oneverruns durable schedules resume --schedule-id sched_01h9 --reason 'Failures fixed'durable schedules trigger
Section titled “durable schedules trigger”Manually trigger a durable schedule.
everruns durable schedules trigger [OPTIONS] --schedule-id <schedule_id>| Flag | Description |
|---|---|
--schedule-id <SCHEDULE_ID> | Required. Schedule’s prefixed public identifier. |
Example:
# Run a schedule once now to test its targeteverruns durable schedules trigger --schedule-id sched_01h9 --reason 'Verify the target before the next run'durable schedules update
Section titled “durable schedules update”Update a durable schedule.
everruns durable schedules update [OPTIONS] --schedule-id <schedule_id>| Flag | Description |
|---|---|
--catch-up-missed | Catch up missed triggers. |
--cron-expression <CRON_EXPRESSION> | New cron expression. |
--description <DESCRIPTION> | New description. |
--enabled | Enable/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:
# Move a schedule to a different timeeverruns durable schedules update --schedule-id sched_01h9 --cron-expression '0 3 * * *' --reason 'Avoid the 02:00 backup window'durable schedules executions list
Section titled “durable schedules executions list”List executions for a durable schedule.
everruns durable schedules executions list [OPTIONS] --schedule-id <schedule_id>| Flag | Description |
|---|---|
--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:
# Find recent failed runs of a scheduleeverruns durable schedules executions list --schedule-id sched_01h9 --status faileddurable schedules stats get
Section titled “durable schedules stats get”Get durable schedule statistics.
everruns durable schedules stats get [OPTIONS] --schedule-id <schedule_id>| Flag | Description |
|---|---|
--schedule-id <SCHEDULE_ID> | Required. Schedule’s prefixed public identifier. |
Example:
# See a schedule's success and failure countseverruns durable schedules stats get --schedule-id sched_01h9