Skip to content
You're viewing documentation for v2026.11.12-beta. It may be out of date.Go to latest
TimescaleDB Enterprise
Esc
↑↓navigate↵open⌘Jpreview

Preview a cron schedule

Checks a cron expression as a create does, and gives its next three runs in UTC. The UI calls it while the admin types the expression.

GET/api/v1/console-backup/schedules/next-runs
Authorization
tse_sessionAPI key · cookierequired
Query parameters
cronstringrequired

A cron expression of 5 fields, in UTC

Responses
200

OK

cronstringrequired

The expression in its normal form, as the console stores it

next_runsstring<date-time>[]required

The next three runs, in UTC

default

Error

codestring

Stable code of the refusal, when the route has codes

detailsstring[]

Additional detail, e.g. per-field validation failures

errorstringrequired

Human-readable error message

Request
curl -X GET 'https://console.example.com/api/v1/console-backup/schedules/next-runs?cron=string' \
  -H 'Cookie: tse_session=YOUR_API_KEY' \
  -H 'Accept: application/json'
Response
{
  "cron": "string",
  "next_runs": [
    "2019-08-24T14:15:22Z"
  ]
}