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

Replace a site's scheduled tasks

Replaces the whole set at the version you read. A task you leave out is removed; a task without an id is added. A change to what runs answers 201 with an operation to follow; a save that changes nothing, or only labels, answers 200 with operation null.

PUT/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.

Body

builtin_enabledboolean or null

The built-in task's switch. Leave it out, or send null, to keep it as it is.

confirm_labelsarray of strings

The exact label of each task the save removes. Asked for only while removal confirmation is on for the API; otherwise it is accepted and ignored. It is checked either way: more than 49 labels, or one longer than 60 characters, is refused invalid.

enabledbooleanRequired

Whether scheduled tasks run on this site at all.

entriesarray of objectsRequired

Every task the site should have after the save, in order. Up to 49 items.

Fields of each item
commandstringRequired

The command to run. A command that could harm the site or reach outside it, or that has a password or key written in it, is refused. Up to 500 characters.

enabledboolean

Defaults to true.

idinteger

The id of a task to keep. Leave it out to add a task. At least 1.

labelstringRequired

One line of plain text, not blank, unique within the site whatever its letters' case. Up to 60 characters.

no_overlapboolean

Defaults to true.

schedulestringRequired

Five cron fields (minute, hour, day of month, month, day of week).

timeoutinteger

Defaults to 3600.

900360021600
versionintegerRequired

The version you read. At least 0.

Returns

200 Saved, and nothing that runs changed. operation is null.

201 Saved. operation is the crons_change operation that applies the set to the site.

Fields of the 200 answer
cronsobjectRequired

A site's scheduled tasks.

Fields
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.

operationobject or any or nullRequired

The operation applying the change, or null when nothing that runs changed.

warningsarray of strings

One line for each task kept unchanged with a password or key written in its command. Left out when there is none.

Fields of the 201 answer
cronsobjectRequired

A site's scheduled tasks.

Fields
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.

operationobject or any or nullRequired

The operation applying the change, or null when nothing that runs changed.

warningsarray of strings

One line for each task kept unchanged with a password or key written in its command. Left out when there is none.

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.
409busyAnother operation is running on the site. Wait for it to finish.
409confirm_mismatchSend the confirmation exactly as the field named in field asks for it.
409conflictThe action conflicts with the object's present state. Read the message.
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.
409managed_elsewhereThis site is read-only here. Change it in the control panel that manages it.
409provisioningThe site is still being created. Try again in a few minutes.
409removedThe site or environment is being removed, or has been. Nothing can be changed on it.
409restore_runningA restore is running on the site. Wait for it to finish, then try again.
409staleWhat you read has changed since you read it. Read it again, then send the change with its new version or quote.
422invalidFix the field named in field; errors says why.
429rate_limitedWait for the seconds in Retry-After.
502noneRead the message; it says what happened.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl -X PUT https://manage.corefinity.com/api/corestack/sites/1042/crons \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "entries": [
      {
        "command": "curl -s -o /dev/null https://www.harbourandfinch.example.com/",
        "enabled": true,
        "label": "Warm the cache",
        "no_overlap": true,
        "schedule": "*/15 * * * *",
        "timeout": 900
      }
    ],
    "version": 0
  }'
{
  "crons": {
    "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
  },
  "operation": null
}
Try it

Try it is off for this endpointIt deletes data that cannot be brought back. Copy the request and run it yourself when you are sure.

Was this helpful?
Open in ClaudeOpen in ChatGPT