Parameters
JSON body
Request body
application/jsoncodestringRequiredJob type identifier. A code seen for the first time creates the job automatically. Normalized to [A-Za-z0-9._:-], max 64 characters. Recommended form: <application>:<job>. Keep it stable: never put ids, dates or arguments into it.
eshop:sync-ordersnamestring | nullOptionalHuman-readable job name shown in the admin. Ignored when empty, equal to code, or after the job was renamed in the admin.
expirationnumber | nullOptionalIdle timeout in seconds. Every log / heartbeat call extends it again. When no call arrives in time the run is closed as timeout and a critical log entry is written. Default 3600 (60 min).
900metaobject | nullOptionalContext of the run (host, version, arguments), up to 16 KB of JSON.
tierstring | nullOptionalScheduler bucket, filterable in the admin job list.
nightlyidempotencyKeystring | nullOptionalWhen a call is retried with the same key for the same job, the existing run is returned (reused: true).
schedulestring | nullOptionalExpected schedule as a cron expression (5 fields, or 6 with leading seconds; macros like @daily). Enables the dead man's switch: when no run starts within the grace period after an expected time, a critical "missed run" alert is raised. null removes the schedule, omitting it keeps the stored one (falls back to meta.schedule). An invalid value does not reject the run; it is ignored and reported in warnings. A schedule edited in the admin takes precedence.
*/5 * * * *scheduleTimezonestring | nullOptionalIANA time zone of schedule. Default UTC.
Europe/PraguegraceSecondsstring | integer | nullOptionalSeconds after an expected start before it counts as missed. Default 10 % of the interval, at least 5 min, at most 1 h.
0Seconds after an expected start before it counts as missed. Default 10 % of the interval, at least 5 min, at most 1 h.