Skip to content
โ—‡ AirawatOS Developer
๐Ÿšง Under development โ€” this portal is being built track by track. Content will keep growing, and some sections are still placeholders.

Reference

โ† Schema catalogue

platform.schedule

domain: platform

A SCHEDULE โ€” the clock-driven trigger, the third way to run a component alongside manual (a person) and event (platform.subscription). Domain-agnostic, tenant-owned config (a Studio/Components app edits it): a cron expression + the component to run. A generic scheduler service ticks, finds due schedules, and fires the SAME confined run path a manual or event trigger uses (kernel run-token โ†’ host โ†’ broker). The scheduler stamps last_run/next_run/last_status back onto the record. 'Run the terrain driver nightly at 02:00' is one schedule record, not code.

FieldTypeRequiredDescription
schemaโ€”โœ“
idstringโœ“
namestring
tenantstringthe tenant that owns this schedule (its steward prefix)
componentstringโœ“component_id to run (must be installed in this tenant)
cronstringโœ“5-field cron: 'min hour dom mon dow' โ€” supports *, */n, a,b lists, a-b ranges. e.g. '0 2 * * *' = daily 02:00
tzstringIANA timezone the cron is evaluated in
enabledboolean
overlapstringskip = don't start if the previous run is still going (guard against pile-up)
catch_upbooleanif the scheduler was down over a due time, run once on recovery (else the missed tick is skipped)
last_runstringISO8601 of the last fire (stamped by the scheduler)
next_runstringISO8601 of the next due time (computed by the scheduler)
last_statusstringoutcome of the last run: ok | error | skipped-overlap | <exit-code>