CorefinityCorefinityDocs
Open the Control PanelControl Panel
Scheduled tasks · 1 of 3

Get a site's scheduled tasks

Answers the whole set: its version, the switch for the site, the built-in task, each task with its id, next run and last run, and whether the last change has been applied.

GET/api/corestack/sites/{site}/crons

Path parameters

siteintegerRequired

The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.

Returns

200 The set of scheduled tasks.

Fields of the 200 answer
applyobjectRequired

Whether a saved set of rules is live on the site.

Fields
applied_atstring or nullRequired
detailany

Sent only by the sets that have more to say, such as HTTP authentication.

errorstring or nullRequired
operationobject or any or nullRequired

The change that is applying the set, while one is running.

statestringRequired

Such as applied or applying.

state_labelstringRequired
builtinobjectRequired

The task the platform needs for itself. You can switch it off and on, but not edit or remove it.

Fields
activebooleanRequired

True when both this switch and the site's enabled are on, so the task runs.

commandstringRequired
enabledbooleanRequired

The task's own switch.

labelstringRequired
last_runobject or any or nullRequired
lockedbooleanRequired

Always true. The task cannot be edited or removed.

notestring or nullRequired
schedulestringRequired
timeoutinteger or nullRequired

The longest a run may take, in seconds.

toggleablebooleanRequired

Always true. The task has a switch of its own, builtin_enabled on a save.

enabledbooleanRequired

Whether scheduled tasks run on this site at all.

enabled_defaultbooleanRequired

What enabled starts as for this kind of site.

entriesarray of objectsRequired
Fields of each item
commandstringRequired
enabledbooleanRequired
idintegerRequired

At least 1.

labelstringRequired
last_runobject or any or nullRequired
next_run_atstring or nullRequired

Null while the task or the site's switch is off. Format: date-time.

no_overlapbooleanRequired

True skips a run while the previous one is still going.

positionintegerRequired

The task's place in the set, starting at 1.

schedulestringRequired

Five cron fields.

schedule_labelstringRequired

The schedule in words.

timeoutintegerRequired

The longest a run may take, in seconds.

limitsobjectRequired
Fields
command_maxintegerRequired

The most characters in a command.

entries_maxintegerRequired

The most tasks a site can have, not counting the built-in task.

label_maxintegerRequired

The most characters in a label.

min_interval_secondsintegerRequired
timeoutsarray of integersRequired

The values timeout accepts, in seconds.

presetsarray of objectsRequired

Schedules the Control Panel offers when you add a task.

Fields of each item
keystringRequired
labelstringRequired
schedulestringRequired
runsobject or any or nullRequired

The last finished run of each task, keyed builtin for the built-in task and c<id> for a task. An empty object before the first run; null when the runs cannot be read at the moment.

timezonestringRequired

The time zone every schedule is read in.

versionintegerRequired

Send this back with a save. It changes whenever the set changes. At least 0.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404feature_offThis feature is not on for your organisation yet.
409deletedThe site, environment or copy has been deleted, or is being deleted. Nothing can be changed on it. Restore a deleted site first if it can still be restored.
409provisioningThe site is still being created. Try again in a few minutes.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/corestack/sites/1042/crons \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "apply": {
    "applied_at": "2026-11-04T14:12:31Z",
    "error": null,
    "operation": null,
    "state": "applied",
    "state_label": "Applied"
  },
  "builtin": {
    "active": true,
    "command": "wp cron event run --due-now",
    "enabled": true,
    "label": "WordPress cron",
    "last_run": {
      "at": "2026-11-06T09:15:04Z",
      "duration_s": 4,
      "exit_code": 0,
      "status": "ok"
    },
    "locked": true,
    "note": "Runs WordPress's scheduled events every 5 minutes. It runs only while Scheduled tasks are on. Built into the platform: you can switch it off or back on at any time, but not edit or remove it.",
    "schedule": "*/5 * * * *",
    "timeout": 240,
    "toggleable": true
  },
  "enabled": true,
  "enabled_default": true,
  "entries": [
    {
      "command": "wp db export /tmp/db.sql",
      "enabled": true,
      "id": 12,
      "label": "Nightly database export",
      "last_run": {
        "at": "2026-11-06T01:31:12Z",
        "duration_s": 72,
        "exit_code": 0,
        "status": "ok"
      },
      "next_run_at": "2026-11-07T02:30:00+01:00",
      "no_overlap": true,
      "position": 1,
      "schedule": "30 2 * * *",
      "schedule_label": "Daily at 02:30",
      "timeout": 3600
    },
    {
      "command": "wp transient delete --expired",
      "enabled": false,
      "id": 13,
      "label": "Clear expired transients",
      "last_run": null,
      "next_run_at": null,
      "no_overlap": false,
      "position": 2,
      "schedule": "0 */6 * * *",
      "schedule_label": "Every 6 hours",
      "timeout": 900
    }
  ],
  "limits": {
    "command_max": 500,
    "entries_max": 49,
    "label_max": 60,
    "min_interval_seconds": 60,
    "timeouts": [
      900,
      3600,
      21600
    ]
  },
  "presets": [
    {
      "key": "every_minute",
      "label": "Every minute",
      "schedule": "* * * * *"
    },
    {
      "key": "every_5_minutes",
      "label": "Every 5 minutes",
      "schedule": "*/5 * * * *"
    },
    {
      "key": "every_15_minutes",
      "label": "Every 15 minutes",
      "schedule": "*/15 * * * *"
    },
    {
      "key": "hourly",
      "label": "Hourly, on the hour",
      "schedule": "0 * * * *"
    },
    {
      "key": "daily",
      "label": "Daily at 03:00",
      "schedule": "0 3 * * *"
    },
    {
      "key": "weekly",
      "label": "Mondays at 03:00",
      "schedule": "0 3 * * 1"
    },
    {
      "key": "monthly",
      "label": "On the 1st of each month at 03:00",
      "schedule": "0 3 1 * *"
    }
  ],
  "runs": {
    "builtin": {
      "at": "2026-11-06T09:15:04Z",
      "duration_s": 4,
      "exit_code": 0,
      "status": "ok"
    },
    "c12": {
      "at": "2026-11-06T01:31:12Z",
      "duration_s": 72,
      "exit_code": 0,
      "status": "ok"
    }
  },
  "timezone": "Europe/London",
  "version": 7
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT