Skip to main content
Validate a cron schedule expression with the Public API (V2) before you configure a cron check-in. The endpoint authenticates with your personal API token.

​
Test a cron expression

POST /api/v2/check_ins/test_cron

​
Request body

FieldTypeRequiredDescription
cronstringYesCron expression to test, such as 0 * * * *.
wait_time_minutesnumberYesWait time in minutes for the check-in window.
timezonestringNoTimezone for evaluation, such as Europe/Amsterdam. Defaults to UTC.
timestampnumberNoUnix timestamp to evaluate against. Defaults to the current time.
{
  "cron": "0 2 * * *",
  "wait_time_minutes": 5,
  "timezone": "UTC"
}

​
Response

Returns now (the timestamp used for evaluation), next_start (the next scheduled start), and next_end (the next scheduled end, which is the start plus the wait time). If the expression is invalid, error contains the reason and the schedule fields are absent.