Skip to main content
POST
Test a cron expression
Use it to check a cron expression before you create a cron process monitor.

Authorizations

Authorization
string
header
required

Authorization: Bearer <token>

Body

application/json

Request body for testing a cron schedule expression.

cron
string
required

Cron expression to test (e.g. "0 * * * *").

wait_time_minutes
integer<int64>
required

Wait time in minutes for the check-in window.

timestamp
integer<int64> | null

Unix timestamp in seconds to evaluate against. Defaults to the current time.

timezone
string
default:""

IANA timezone for cron evaluation (e.g. "Europe/Amsterdam"). An empty string means UTC.

Response

The next window, or an error message when the input is invalid.

Result of evaluating a cron schedule expression.

now
string<date-time>
required

The time evaluated against: timestamp, or the current time when omitted or out of range.

next_start
string<date-time> | null
required

Next scheduled start time; null when error is set.

next_end
string<date-time> | null
required

Next scheduled end time (start + wait time); null when error is set.

error
string | null
required

Why no window could be computed (invalid expression, timezone or timestamp); null on success.