Job

Cron Schedule Schema

Schedule jobs using cron expressions

Source: packages/spec/src/system/job.zod.ts

TypeScript Usage

import { CronSchedule, IntervalSchedule, Job, JobExecution, JobExecutionStatus, OnceSchedule, RetryPolicy, Schedule } from '@objectstack/spec/system';
import type { CronSchedule, IntervalSchedule, Job, JobExecution, JobExecutionStatus, OnceSchedule, RetryPolicy, Schedule } from '@objectstack/spec/system';

// Validate data
const result = CronSchedule.parse(data);

CronSchedule

Properties

Property	Type	Required	Description
type	`string`	✅
expression	`string`	✅	Cron expression (e.g., "0 0 * * *" for daily at midnight)
timezone	`string`	✅	Timezone for cron execution (e.g., "America/New_York")

IntervalSchedule

Properties

Property	Type	Required	Description
type	`string`	✅
intervalMs	`integer`	✅	Interval in milliseconds

Properties

Property	Type	Required	Description
id	`string`	✅	Unique job identifier
name	`string`	✅	Job name (snake_case)
schedule	`Object \| Object \| Object`	✅	Job schedule configuration
handler	`string`	✅	Handler path (e.g. "path/to/file:functionName") or script ID
retryPolicy	`Object`	optional	Retry policy configuration
timeout	`integer`	optional	Timeout in milliseconds
enabled	`boolean`	✅	Whether the job is enabled

JobExecution

Properties

Property	Type	Required	Description
jobId	`string`	✅	Job identifier
startedAt	`string`	✅	ISO 8601 datetime when execution started
completedAt	`string`	optional	ISO 8601 datetime when execution completed
status	`Enum<'running' \| 'success' \| 'failed' \| 'timeout'>`	✅	Execution status
error	`string`	optional	Error message if failed
duration	`integer`	optional	Execution duration in milliseconds

JobExecutionStatus

Allowed Values

running
success
failed
timeout

OnceSchedule

Properties

Property	Type	Required	Description
type	`string`	✅
at	`string`	✅	ISO 8601 datetime when to execute

RetryPolicy

Properties

Property	Type	Required	Description
maxRetries	`integer`	✅	Maximum number of retry attempts
backoffMs	`integer`	✅	Initial backoff delay in milliseconds
backoffMultiplier	`number`	✅	Multiplier for exponential backoff

Schedule

Union Options

This schema accepts one of the following structures:

Option 1

Type: cron

Properties

Property	Type	Required	Description
type	`string`	✅
expression	`string`	✅	Cron expression (e.g., "0 0 * * *" for daily at midnight)
timezone	`string`	✅	Timezone for cron execution (e.g., "America/New_York")

Option 2

Type: interval

Properties

Property	Type	Required	Description
type	`string`	✅
intervalMs	`integer`	✅	Interval in milliseconds

Option 3

Type: once

Properties

Property	Type	Required	Description
type	`string`	✅
at	`string`	✅	ISO 8601 datetime when to execute

Job

On this page