<interval>

<interval> admits runs at a fixed duration between planned instants.

Why use it

Use it when frequency matters more than calendar time and slow runs must not shift the future schedule.

Common use cases

• Refresh a cache every five minutes.
• Poll a system at a fixed cadence.
• Run periodic reconciliation independent of run duration.

Syntax

<interval id="refreshCache" every="5m" on-missed="skip" />

Rules and behavior

• id and every are required.
• every ranges from 1s through 30d.
• on-missed is skip or run-once and defaults to skip.
• Intervals use an anchored fixed-rate grid.
• The payload contains RFC 3339 UTC scheduledAt and triggeredAt values.

Related documentation

• Schedules, intervals, and events
• The schedule tag