CorefinityCorefinityDocs
Open the Control PanelControl Panel
Platform plugins · 2 of 2

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.

PUT/api/corestack/sites/{site}/platform-plugins

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

confirm_offboolean

Send true with enabled: false, once the person has read stops and agreed. Not needed to turn them on. Defaults to false.

enabledbooleanRequired

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
changedbooleanRequired

False when the site already had the value sent, so nothing was done.

operationobject or any or nullRequired

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.

platform_pluginsobjectRequired

A WordPress site's platform plugins: whether they run, and what turning them off would stop.

Fields
appliesbooleanRequired

True for a WordPress site. No other platform has platform plugins.

applyingbooleanRequired

True while the platform is still applying the last change.

can_changebooleanRequired

True when you may change the setting: only the site's managing agency and Corefinity can.

changed_atstring or nullRequired

When they were turned off, with a +00:00 offset rather than Z. Null while they are on. Format: date-time.

cut_overbooleanRequired

True once the site is past its go-live hold. The platform plugins can then no longer be turned off.

enabledbooleanRequired

Whether the platform plugins run. True until somebody turns them off.

keyedbooleanRequired

True for a production site whose setting is also applied by the platform as an operation; a change then answers that operation.

layoutstringRequired

The WordPress layout found on the site.

classicbedrock
layout_labelstringRequired
needs_attentionstring or nullRequired

A sentence saying what to do when the last change could not be confirmed on the site. Null otherwise.

off_notestring or nullRequired

What to know before turning them off, when a turn-off is still possible.

off_refusedstring or nullRequired

Why a turn-off would be refused, when that is already known.

off_warningstring or nullRequired

What else a turn-off ends, when a turn-off is still possible.

reasonstringRequired

The sentence those tools are refused with.

refused_functionsarray of stringsRequired

The site tools that are refused while the platform plugins are off.

runtime_readybooleanRequired

Whether the site's software can turn the platform plugins off. When false, a turn-off is refused runtime_lacks_capability.

stopsarray of stringsRequired

What stops working while the platform plugins are off, in plain words. Show this before sending confirm_off.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403forbiddenThe person is not allowed to do this.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404noneCheck the id. You see only what your account can reach.
409busyAnother operation is running on the site. Wait for it to finish.
409command_runningAnother action or command is still running on the site. Wait for it to finish, then try again.
409exec_unresolvedAn earlier command on the site has not been confirmed stopped. Contact support.
409managed_elsewhereThis site is read-only here. Change it in the control panel that manages it.
409not_runningThe 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.
409runtime_lacks_capabilityThe site's runtime does not support this yet. It is available after the site's platform update.
409site_cut_overThe site is past its go-live hold, so its platform plugins can no longer be turned off. Nothing to change.
409wrong_platformThis is not available for the site's platform. Use it on a site of the platform it is for.
422confirmThe action needs an explicit confirmation field. Ask the person, then send it.
422invalidFix the field named in field; errors says why.
429rate_limitedWait for the seconds in Retry-After.
503connect_failedThe cluster could not be reached.
503cut_over_unknownWhether the site is past its go-live hold could not be confirmed, so nothing was changed. Try again in a minute.
503unavailableThis 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.
503switched_offCorefinity 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
  }'
{
  "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"
    ]
  }
}
Try it

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.

Was this helpful?
Open in ClaudeOpen in ChatGPT