List scheduled job runs
list_site_cron_runs
Lists recent runs of the scheduled jobs on a site, newest first, 25 to a page.
Scopeconfig:readRead only
The response carries nextCursor. Pass it back as cursor for the next page, and it is null once there is nothing more. This is the tool to reach for when you want to know why a job did not fire or what it returned.
Runs are kept for 30 days, and runs hidden with delete_site_cron_run or clear_site_cron_runs no longer appear. A deploy hook token inside a URL comes back as mdh_<redacted>, because that URL can publish the site, and reading it needs get_deploy_hook_url. See Scheduled jobs.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
projectId |
string | Yes | The site id. |
cronId |
string | No | Only runs of this one job, by its id from list_site_crons. Leave it out for the runs of every job on the site. |
status |
string | No | Which runs to keep, all, success, failure, or manual for the runs someone triggered by hand rather than on the schedule. Defaults to all. |
sort |
string | No | newest first, the default, or oldest to walk the history forwards from the beginning. |
cursor |
string | No | The nextCursor from the previous page. Leave it out for the first page. |