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.
startedAtstringRequiredISO-8601 start of the run (at most 7 days old).
2026-11-05T12:00:00.120ZfinishedAtstringRequiredISO-8601 end of the run, not before startedAt.
2026-11-05T12:00:00.480Zstatus"success" | "error" | nullOptionalOutcome of the run. Defaults to success.
messagestring | nullOptionalFinal message, e.g. the error text. null = none.
reportobject | nullOptionalSummary of the run, e.g. { "processed": 120 }, up to 16 KB. null = none.
exitCodestring | integer | nullOptional0peakMemoryMbstring | integer | nullOptional0heapUsedMbstring | integer | nullOptional0entriesobject[] | nullOptionalLog entries of the run, in order.
level"info" | "success" | "error" | "warning" | "critical" | nullOptionalSeverity of the entry. Defaults to info.
messagestringRequiredLog message (stored up to 4000 characters).
contextobject | nullOptionalStructured context, up to 16 KB of JSON.
clientDatestring | nullOptionalISO-8601 time the entry was produced on the client.
2026-11-05T10:15:00.000Z