Update a site's platform plugins
Turns the platform's own plugins on or off for a WordPress site. Only the site's managing agency and Corefinity may change it. A turn-off needs confirm_off: true, sent once the person has agreed to what stops lists.
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
Send true with enabled: false, once the person has read stops and agreed. Not needed to turn them on. Defaults to false.
True to turn the platform plugins on, false to turn them off.
Returns
200 The setting after the request. On a production site operation is the change being applied: follow operation.id until it completes.
Fields of the 200 answer
False when the site already had the value sent, so nothing was done.
The operation applying the change on a production site. Null when none started. This answer writes its times with a +00:00 offset and leaves out install, step and label; reading the operation by its id answers the full form.
A WordPress site's platform plugins: whether they run, and what turning them off would stop.
Fields
True for a WordPress site. No other platform has platform plugins.
True while the platform is still applying the last change.
True when you may change the setting: only the site's managing agency and Corefinity can.
When they were turned off, with a +00:00 offset rather than Z. Null while they are on. Format: date-time.
True once the site is past its go-live hold. The platform plugins can then no longer be turned off.
Whether the platform plugins run. True until somebody turns them off.
True for a production site whose setting is also applied by the platform as an operation; a change then answers that operation.
The WordPress layout found on the site.
classicbedrockA sentence saying what to do when the last change could not be confirmed on the site. Null otherwise.
What to know before turning them off, when a turn-off is still possible.
Why a turn-off would be refused, when that is already known.
What else a turn-off ends, when a turn-off is still possible.
The sentence those tools are refused with.
The site tools that are refused while the platform plugins are off.
Whether the site's software can turn the platform plugins off. When false, a turn-off is refused runtime_lacks_capability.
What stops working while the platform plugins are off, in plain words. Show this before sending confirm_off.
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 | forbidden | The person is not allowed to do this. |
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 | none | Check the id. You see only what your account can reach. |
409 | busy | Another operation is running on the site. Wait for it to finish. |
409 | command_running | Another action or command is still running on the site. Wait for it to finish, then try again. |
409 | exec_unresolved | An earlier command on the site has not been confirmed stopped. Contact support. |
409 | managed_elsewhere | This site is read-only here. Change it in the control panel that manages it. |
409 | not_running | The site, environment or deployment is not running. Read the message: where it can be started or will recover, start it or wait, then try again. |
409 | runtime_lacks_capability | The site's runtime does not support this yet. It is available after the site's platform update. |
409 | site_cut_over | The site is past its go-live hold, so its platform plugins can no longer be turned off. Nothing to change. |
409 | wrong_platform | This is not available for the site's platform. Use it on a site of the platform it is for. |
422 | confirm | The action needs an explicit confirmation field. Ask the person, then send it. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait for the seconds in Retry-After. |
503 | connect_failed | The cluster could not be reached. |
503 | cut_over_unknown | Whether the site is past its go-live hold could not be confirmed, so nothing was changed. Try again in a minute. |
503 | unavailable | This is not available for the site or environment, or not at the moment. Read the message; try again later where it says so, or contact support. |
503 | switched_off | Corefinity has switched this action off for the moment. Try again later. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X PUT https://manage.corefinity.com/api/corestack/sites/1042/platform-plugins \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"confirm_off": true,
"enabled": false
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->put('https://manage.corefinity.com/api/corestack/sites/1042/platform-plugins', [
'confirm_off' => true,
'enabled' => false,
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/platform-plugins', {
method: 'PUT',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
confirm_off: true,
enabled: false,
}),
});
// 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/platform-plugins",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"confirm_off": True,
"enabled": False,
},
)
data = res.json() if res.content else None{
"changed": true,
"operation": {
"applied_at": null,
"can_retry": false,
"cluster": {
"id": 1017,
"name": "Northwind UK 1"
},
"committed_at": "2026-11-03T09:16:40+00:00",
"completed_at": null,
"created_at": "2026-11-03T09:16:40+00:00",
"environment": {
"env_id": "rs-northwind-journal-harbourandfinch-example-com",
"hostname": "journal-harbourandfinch-example-com.northwind.cfstack.example.net",
"id": 1051,
"name": "Production",
"role": "production",
"role_label": "Production",
"slug": "production"
},
"error": null,
"failure_reason": null,
"from_version": null,
"hot": false,
"id": 5120,
"notes": [],
"parent_operation_id": null,
"requested_by": {
"id": 2012,
"name": "Daniel Reyes"
},
"result": null,
"result_state": "none",
"retried_by_operation_id": null,
"retries_operation_id": null,
"retry_requires": null,
"scope": "site",
"site": {
"domain": "journal.harbourandfinch.example.com",
"id": 1051
},
"status": "committed",
"status_label": "In progress",
"steps": [
{
"key": "saved",
"label": "Saved",
"state": "done"
},
{
"key": "applied",
"label": "Applied by the platform",
"state": "current"
}
],
"subject": null,
"summary": "Platform plugins",
"to_version": null,
"type": "platform_plugins_key",
"type_label": "Platform plugins"
},
"platform_plugins": {
"applies": true,
"applying": true,
"can_change": true,
"changed_at": "2026-11-03T09:16:40+00:00",
"cut_over": false,
"enabled": false,
"keyed": true,
"layout": "classic",
"layout_label": "Standard WordPress",
"needs_attention": null,
"off_note": null,
"off_refused": null,
"off_warning": null,
"reason": "Needs the platform plugin, which is turned off for this site.",
"refused_functions": [
"wp_login_link"
],
"runtime_ready": true,
"stops": [
"One-click login to wp-admin from the Control Panel",
"Viewing the site on its platform address: WordPress sends visitors to its own address instead",
"Before go-live: email, payments and outgoing requests are no longer held back",
"Before go-live: the platform address is no longer kept out of caches",
"The Control Panel's From address for email sent with PHP mail",
"On a preview environment: email from SMTP plugins is no longer caught, and known live integrations are no longer blocked"
]
}
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"message": "Not found."
}{
"code": "busy",
"message": "Another change to this site is in progress. Wait for it to finish.",
"reason": "busy"
}{
"code": "confirm",
"message": "Turning the platform plugins off stops what is listed in stops. Send confirm_off: true once the person has agreed.",
"reason": "confirm",
"stops": [
"One-click login to wp-admin from the Control Panel",
"Viewing the site on its platform address: WordPress sends visitors to its own address instead",
"Before go-live: email, payments and outgoing requests are no longer held back",
"Before go-live: the platform address is no longer kept out of caches",
"The Control Panel's From address for email sent with PHP mail",
"On a preview environment: email from SMTP plugins is no longer caught, and known live integrations are no longer blocked"
]
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}{
"code": "connect_failed",
"message": "The cluster could not be reached",
"reason": "connect_failed"
}Try it is off for this endpointIt has not been cleared for the console. Copy the request and run it yourself when you are sure.