CorefinityCorefinityDocs
Open the Control PanelControl Panel
Essentials · 9 of 12

Apply now or in a window

Some changes can wait for the site's maintenance window instead of applying at once.

On this page

Endpoints whose change is applied in a maintenance window take an apply field in the JSON body. An endpoint without apply on its reference page cannot be queued this way.

An endpoint whose apply lists now alone always applies at once, and is not in the tables below.

Changes that take apply

ChangeWhat it does
PUT /corestack/sites/{site}/mariadb-versionUpdate a site's MariaDB version
PUT /corestack/sites/{site}/php-versionUpdate a site's PHP version
PUT /corestack/sites/{site}/addonsUpdate a site's add-ons
POST /corestack/clusters/{cluster}/compute-familySwitch a CoreCluster's server type
POST /corestack/sites/{site}/compute-familySwitch a site's server type
PATCH /corestack/sites/{site}/environmentUpdate an environment
POST /corestack/sites/{site}/packageUpdate a site's package
PUT /corestack/sites/{site}/nginx-rulesReplace a site's Nginx rules
POST /corestack/sites/{site}/nginx-rules/copyCopy Nginx rules between environments
POST /corestack/sites/{site}/nginx-rules/revisions/{revision}/revertRestore an Nginx revision
PUT /corestack/sites/{site}/node-runtimeUpdate a site's Node.js configuration
PUT /corestack/sites/{site}/php-runtimeUpdate a site's PHP configuration
POST /corestack/sites/{site}/php-runtime/apply-toCopy PHP configuration to other environments
POST /corestack/sites/{site}/php-runtime/revertRestore a PHP configuration revision
PUT /corestack/sites/{site}/php-settingsUpdate memory, upload and execution limits
POST /corestack/sites/{site}/runtime/adoptMove a site onto the runtime
POST /corestack/sites/{site}/varnishUpdate a site's Varnish switch by POST
PUT /corestack/sites/{site}/varnishUpdate a site's Varnish switch
PUT /corestack/sites/{site}/varnish/versionUpdate a site's Varnish version

Values

applyMeaning
nowApply at once. The default
tonightQueue the change for the site's next maintenance window
windowThe same as tonight

window is accepted while maintenance windows are on for your company. Otherwise it is refused 422 on apply.

The queued answer

A queued change answers 201 with no operation, because nothing has started.

A queued Varnish change answers 202 with the same body.

json
{
  "operation": null,
  "queued": true,
  "window_date": "2026-11-04",
  "item_id": 5012,
  "window": {
    "starts_at": "2026-11-04T00:00:00Z",
    "ends_at": "2026-11-04T04:00:00Z",
    "label": "00:00–04:00 UK time",
    "source": "platform",
    "policy": "site"
  }
}
FieldMeaning
window_dateThe date of the window the change waits for
item_idThe id of the pending change, used to cancel it
windowThe window itself. Present only while maintenance windows are on for your company; may be null

Pending changes

Queued changes can be read, applied early or cancelled. These endpoints answer 404 feature_off when queued changes are not on for your company.

EndpointScopeDoes
GET /corestack/sites/{site}/pending-changesreadLists what waits and for which window
POST /corestack/sites/{site}/pending-changes/apply-nowwriteApplies them all now with {"confirm": true} and answers an operation
DELETE /corestack/sites/{site}/pending-changes/{item}writeCancels one of your changes
GET /corestack/pending-changes/attentionreadLists queued changes and recent failed windows across your sites

Refusals

StatusreasonWhat to do
422feature_offtonight is not available for your company; send apply: now
422confirmSend {"confirm": true} with apply-now
409nothing_pendingNothing is queued
409batch_window, batch_runningThe window is running; wait for it to finish
409item_stateThe change was already applied or cancelled, or is not yours
Was this helpful?
Open in ClaudeOpen in ChatGPT