Schedule Trigger

Type: schedule_trigger • Category: trigger • Tags: time, schedule

Description

Schedule workflow execution (interval / one-shot)

Parameters

Name	Type	Description	Required	Default
everySeconds	number	Run every N seconds	no	86400
atTimestamp	number	Run once at UNIX timestamp (seconds)	no
cron	string	Cron expression (future)	no
idempotent	boolean		no	true
update	boolean	Force update existing schedule	no	false

Help

Overview

This worker schedules the execution of a workflow that retrieves or processes financial‑market data. It can trigger the workflow on a recurring interval, at a specific UNIX timestamp, or (in a future release) via a cron expression. The scheduling is idempotent by default, meaning that repeated requests with the same identifier will not create duplicate schedules unless explicitly overridden.

Inputs

• everySeconds (number, default = 86400) – Interval, in seconds, between successive executions. Set to 86400 for a daily run.
• atTimestamp (number) – A single execution time expressed as a UNIX timestamp (seconds since epoch). If supplied, the workflow runs only once at the given moment.
• cron (string) – A cron‑style schedule expression (currently reserved for future implementation).
• idempotent (boolean, default = true) – When true, the worker treats identical scheduling requests as the same job, preventing duplicate entries.
• update (boolean, default = false) – If true, an existing schedule that matches the supplied parameters will be overwritten with the new configuration; otherwise the request is ignored when a matching schedule already exists.

Minimal Example Usage

schedule:
  everySeconds: 43200        # run twice daily
  idempotent: true
  update: false

or, for a one‑off execution at a precise moment:

schedule:
  atTimestamp: 1735689600    # UNIX time for 2025‑01‑01 00:00:00 UTC
  idempotent: true

These snippets illustrate the essential fields required to create a recurring or single‑run schedule for the financial‑market workflow. Adjust the parameters as needed to match the desired execution pattern.