Testing cron schedules

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

Field	Type	Required	Description
`cron`	string	Yes	Cron expression to test, such as `0 * * * *`.
`wait_time_minutes`	number	Yes	Wait time in minutes for the check-in window.
`timezone`	string	No	Timezone for evaluation, such as `Europe/Amsterdam`. Defaults to UTC.
`timestamp`	number	No	Unix 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.

Querying deploy statistics

Retrieving saved visuals

⌘I

AppSignal API

MCP server

AppSignal CLI

Test a cron expression

Request body

Response

​Test a cron expression

​Request body

​Response

Test a cron expression

Request body

Response