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.
Path parameters
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
The built-in task's switch. Leave it out, or send null, to keep it as it is.
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.
Whether scheduled tasks run on this site at all.
Every task the site should have after the save, in order. Up to 49 items.
Fields of each item
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.
Defaults to true.
The id of a task to keep. Leave it out to add a task. At least 1.
One line of plain text, not blank, unique within the site whatever its letters' case. Up to 60 characters.
Defaults to true.
Five cron fields (minute, hour, day of month, month, day of week).
Defaults to 3600.
900360021600The 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
A site's scheduled tasks.
Fields
Whether a saved set of rules is live on the site.
Fields
Sent only by the sets that have more to say, such as HTTP authentication.
The change that is applying the set, while one is running.
Such as applied or applying.
The task the platform needs for itself. You can switch it off and on, but not edit or remove it.
Fields
True when both this switch and the site's enabled are on, so the task runs.
The task's own switch.
Always true. The task cannot be edited or removed.
The longest a run may take, in seconds.
Always true. The task has a switch of its own, builtin_enabled on a save.
Whether scheduled tasks run on this site at all.
What enabled starts as for this kind of site.
Fields of each item
At least 1.
Null while the task or the site's switch is off. Format: date-time.
True skips a run while the previous one is still going.
The task's place in the set, starting at 1.
Five cron fields.
The schedule in words.
The longest a run may take, in seconds.
Fields
The most characters in a command.
The most tasks a site can have, not counting the built-in task.
The most characters in a label.
The values timeout accepts, in seconds.
Schedules the Control Panel offers when you add a task.
Fields of each item
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.
The time zone every schedule is read in.
Send this back with a save. It changes whenever the set changes. At least 0.
The operation applying the change, or null when nothing that runs changed.
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
A site's scheduled tasks.
Fields
Whether a saved set of rules is live on the site.
Fields
Sent only by the sets that have more to say, such as HTTP authentication.
The change that is applying the set, while one is running.
Such as applied or applying.
The task the platform needs for itself. You can switch it off and on, but not edit or remove it.
Fields
True when both this switch and the site's enabled are on, so the task runs.
The task's own switch.
Always true. The task cannot be edited or removed.
The longest a run may take, in seconds.
Always true. The task has a switch of its own, builtin_enabled on a save.
Whether scheduled tasks run on this site at all.
What enabled starts as for this kind of site.
Fields of each item
At least 1.
Null while the task or the site's switch is off. Format: date-time.
True skips a run while the previous one is still going.
The task's place in the set, starting at 1.
Five cron fields.
The schedule in words.
The longest a run may take, in seconds.
Fields
The most characters in a command.
The most tasks a site can have, not counting the built-in task.
The most characters in a label.
The values timeout accepts, in seconds.
Schedules the Control Panel offers when you add a task.
Fields of each item
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.
The time zone every schedule is read in.
Send this back with a save. It changes whenever the set changes. At least 0.
The operation applying the change, or null when nothing that runs changed.
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
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
409 | busy | Another operation is running on the site. Wait for it to finish. |
409 | confirm_mismatch | Send the confirmation exactly as the field named in field asks for it. |
409 | conflict | The action conflicts with the object's present state. Read the message. |
409 | deleted | The 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. |
409 | managed_elsewhere | This site is read-only here. Change it in the control panel that manages it. |
409 | provisioning | The site is still being created. Try again in a few minutes. |
409 | removed | The site or environment is being removed, or has been. Nothing can be changed on it. |
409 | restore_running | A restore is running on the site. Wait for it to finish, then try again. |
409 | stale | What you read has changed since you read it. Read it again, then send the change with its new version or quote. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait for the seconds in Retry-After. |
502 | none | Read 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
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->put('https://manage.corefinity.com/api/corestack/sites/1042/crons', [
'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,
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/crons', {
method: 'PUT',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
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,
}),
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.put(
"https://manage.corefinity.com/api/corestack/sites/1042/crons",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"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,
},
)
data = res.json() if res.content else None{
"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
}{
"crons": {
"apply": {
"applied_at": "2026-11-04T14:12:31Z",
"error": null,
"operation": {
"id": 77141,
"scope": "site",
"status": "committed",
"status_label": "Waiting for the platform",
"summary": "3 cron entries, enabled",
"to_version": null,
"type": "crons_change",
"type_label": "Scheduled tasks"
},
"state": "applying",
"state_label": "Applying"
},
"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
},
{
"command": "curl -s -o /dev/null https://www.harbourandfinch.example.com/",
"enabled": true,
"id": 14,
"label": "Warm the cache",
"last_run": null,
"next_run_at": "2026-11-06T10:30:00+01:00",
"no_overlap": true,
"position": 3,
"schedule": "*/15 * * * *",
"schedule_label": "Every 15 minutes",
"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": 8
},
"operation": {
"applied_at": null,
"can_retry": false,
"cluster": {
"id": 1017,
"name": "Northwind UK 1"
},
"committed_at": "2026-11-06T09:14:04Z",
"completed_at": null,
"created_at": "2026-11-06T09:14:02Z",
"environment": {
"env_id": "rs-harbourandfinch-example-com",
"hostname": "harbourandfinch-example-com.northwind.cfstack.example.net",
"id": 1042,
"name": "Production",
"role": "production",
"role_label": "Production",
"slug": "production"
},
"error": null,
"failure_reason": null,
"from_version": null,
"hot": true,
"id": 77141,
"install": null,
"label": "Picked up by the platform",
"notes": [],
"parent_operation_id": null,
"requested_by": {
"id": 5021,
"name": "Eleanor Finch"
},
"result": null,
"result_state": "none",
"retried_by_operation_id": null,
"retries_operation_id": null,
"retry_requires": null,
"scope": "site",
"site": {
"domain": "harbourandfinch.example.com",
"id": 1042
},
"status": "committed",
"status_label": "Waiting for the platform",
"step": "applied",
"steps": [
{
"key": "saved",
"label": "Saved",
"state": "done"
},
{
"key": "applied",
"label": "Picked up by the platform",
"state": "current"
},
{
"key": "live",
"label": "Live",
"state": "todo"
}
],
"subject": null,
"summary": "3 cron entries, enabled",
"to_version": null,
"type": "crons_change",
"type_label": "Scheduled tasks"
}
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "busy",
"message": "Another change to this site is in progress. Wait for it to finish.",
"reason": "busy"
}{
"code": "invalid",
"errors": {
"entries.1.command": [
"Entry 2: Command contains `sudo`, which is not allowed in a cron"
]
},
"field": "entries.1.command",
"message": "Entry 2: Command contains `sudo`, which is not allowed in a cron",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"message": "The platform returned an error (HTTP 503). Try again shortly."
}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.