CorefinityCorefinityDocs
Open the Control PanelControl Panel
Pending changes · 2 of 4

List a site's pending changes

Answers the changes waiting for the site's maintenance window, the window itself and whether they can be applied now.

GET/api/corestack/sites/{site}/pending-changes

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.

Returns

200 The pending changes.

Fields of the 200 answer
batchobject or nullRequired

The set of changes that will apply together. Null when nothing is waiting.

Fields
idinteger

At least 1.

statusstring
window_datestring

Format: date.

can_apply_nowobjectRequired

Whether the changes can be applied now. reason says why not, such as nothing_pending or batch_window.

Fields
availablebooleanRequired
reasonstring or nullRequired
environmentobjectRequired
Fields
idintegerRequired

The site row id. At least 1.

namestringRequired
rolestringRequired
slugstringRequired
itemsarray of objectsRequired
Fields of each item
applied_atstring or nullRequired

Format: date-time.

customer_changeobject or nullRequired

What was asked, by whom and when, and whether you can withdraw it. Null for the platform's own changes.

Fields
can_cancelboolean
requested_atstring or null

Format: date-time.

requested_byobject or any or null
summarystring
typestring
errorstring or nullRequired
idintegerRequired

The {item} to withdraw the change with. At least 1.

kindstringRequired

A change somebody asked for is customer_change. Other kinds are the platform's own.

labelstringRequired
positionintegerRequired
source_operationany or null

Always null.

statusstringRequired
noticeboolean

Whether you are told before the window. Sent only while maintenance windows are on for your company.

platform_maintenancearray of objects

Platform maintenance announced for the site. Sent only while maintenance windows are on for your company.

Fields of each item
ends_atstring

Format: date-time.

labelstring
starts_atstring

Format: date-time.

summarystring
siteobjectRequired

A site by its id and domain.

Fields
domainstringRequired
idintegerRequired
windowobjectRequired
Fields
datestringRequired

Format: date.

ends_atstringRequired

Format: date-time.

labelstringRequired
policystring or null

Sent only while maintenance windows are on for your company.

sourcestring or null

Where the window comes from. Sent only while maintenance windows are on for your company.

starts_atstringRequired

Format: date-time.

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.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/corestack/sites/1042/pending-changes \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "batch": {
    "id": 4120,
    "status": "open",
    "window_date": "2026-11-04"
  },
  "can_apply_now": {
    "available": true,
    "reason": null
  },
  "environment": {
    "id": 1042,
    "name": "Production",
    "role": "production",
    "slug": "production"
  },
  "items": [
    {
      "applied_at": null,
      "customer_change": {
        "can_cancel": true,
        "requested_at": "2026-11-04T11:00:00Z",
        "requested_by": {
          "id": 2041,
          "name": "Eleanor Finch"
        },
        "summary": "PHP settings",
        "type": "php_settings"
      },
      "error": null,
      "id": 5320,
      "kind": "customer_change",
      "label": "PHP settings",
      "position": 1,
      "source_operation": null,
      "status": "pending"
    }
  ],
  "site": {
    "domain": "harbourandfinch.example.com",
    "id": 1042
  },
  "window": {
    "date": "2026-11-04",
    "ends_at": "2026-11-05T07:00:00Z",
    "label": "Tonight 21:00–07:00 (Europe/London)",
    "starts_at": "2026-11-04T21:00:00Z"
  }
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT