Cancel a pending change
Withdraws one change you asked for before its window takes it, and answers the pending changes without it.
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.
The id of a pending change, from the site's pending changes. Digits only. At least 1.
Returns
200 The pending changes without it.
Fields of the 200 answer
Fields
The set of changes that will apply together. Null when nothing is waiting.
Fields
At least 1.
Format: date.
Whether the changes can be applied now. reason says why not, such as nothing_pending or batch_window.
Fields
Fields
The site row id. At least 1.
Fields of each item
Format: date-time.
What was asked, by whom and when, and whether you can withdraw it. Null for the platform's own changes.
Fields
Format: date-time.
The {item} to withdraw the change with. At least 1.
A change somebody asked for is customer_change. Other kinds are the platform's own.
Always null.
Whether you are told before the window. Sent only while maintenance windows are on for your company.
Platform maintenance announced for the site. Sent only while maintenance windows are on for your company.
Fields of each item
Format: date-time.
Format: date-time.
A site by its id and domain.
Fields
Fields
Format: date.
Format: date-time.
Sent only while maintenance windows are on for your company.
Where the window comes from. Sent only while maintenance windows are on for your company.
Format: date-time.
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 | feature_off | This feature is not on for your organisation yet. |
409 | item_state | The queued change is no longer in a state that allows this. Read the pending changes again. |
409 | managed_elsewhere | This site is read-only here. Change it in the control panel that manages it. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X DELETE https://manage.corefinity.com/api/corestack/sites/1042/pending-changes/5320 \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->delete('https://manage.corefinity.com/api/corestack/sites/1042/pending-changes/5320');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/pending-changes/5320', {
method: 'DELETE',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// 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.delete(
"https://manage.corefinity.com/api/corestack/sites/1042/pending-changes/5320",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"pending": {
"batch": null,
"can_apply_now": {
"available": false,
"reason": "nothing_pending"
},
"environment": {
"id": 1042,
"name": "Production",
"role": "production",
"slug": "production"
},
"items": [],
"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"
}
}
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "item_state",
"message": "This change can no longer be cancelled.",
"reason": "item_state"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}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.