List a site's operations
Answers the operations of a site or environment, newest first. Paged by cursor: send next_cursor back as cursor; null means the last page.
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.
Query parameters
Items a page. Defaults to 25. 1 to 100.
The next_cursor of the previous answer. Send only a cursor the list gave you; the list's own page says what any other value answers.
Only operations of these types, such as php_version or url_change. Up to 20.
Returns
200 A page of operations.
Fields of the 200 answer
Send as cursor to read the next page. Null on the last page.
Fields of each item
The cluster the operation runs on.
Why the operation failed, in plain words. Null unless status is failed.
A stable code for the failure.
True when the change applies without a maintenance window.
What the operation did differently on purpose. Empty when nothing.
Fields of each item
Who asked for the change.
Present on some site creations and copies.
Always null here. A one-time result is read once with the reveal endpoint.
nonependingavailableviewedWhat a retry needs first, if anything.
Who revealed a one-time result and when, when there was one.
siteclusterbatchThe website the operation belongs to. Null for a cluster's own operation.
Where a change is. completed and failed are final; every other status means the change is still running and blocks another change to the same site.
pendingcommittedrolling_outexecutingcompletedfailedThe key of the step the operation is at. Null once it has completed.
Fields of each item
One of done, current, todo, failed or skipped.
The kind of change, such as crons_change or redirects_change.
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 | 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. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait 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/operations \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/corestack/sites/1042/operations');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/operations', {
method: 'GET',
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.get(
"https://manage.corefinity.com/api/corestack/sites/1042/operations",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"items": [
{
"applied_at": null,
"can_retry": true,
"cluster": {
"id": 1017,
"name": "Northwind UK 1"
},
"committed_at": "2026-11-03T09:12:05Z",
"completed_at": null,
"created_at": "2026-11-03T09:12:03Z",
"environment": {
"env_id": "rs-northwind-harbourandfinch-example-com",
"hostname": "harbourandfinch-example-com.northwind.cfstack.example.net",
"id": 1042,
"name": "Production",
"role": "production",
"role_label": "Production",
"slug": "production"
},
"error": "The change was not applied within 15 minutes — staff have been notified",
"failure_reason": "step_failed",
"from_version": null,
"hot": false,
"id": 5120,
"install": null,
"label": "Site URL updated",
"notes": [],
"parent_operation_id": null,
"requested_by": {
"id": 2041,
"name": "Eleanor Finch"
},
"reset_target": null,
"result": null,
"result_state": "none",
"retried_by_operation_id": null,
"retries_operation_id": null,
"retry_requires": null,
"revealed": null,
"scope": "site",
"site": {
"domain": "harbourandfinch.example.com",
"id": 1042
},
"status": "failed",
"status_label": "Failed",
"step": "rewritten",
"steps": [
{
"key": "committed",
"label": "New address added",
"state": "done"
},
{
"key": "rewritten",
"label": "Site URL updated",
"state": "failed"
},
{
"key": "finalising",
"label": "Redirect saved",
"state": "todo"
},
{
"key": "finalised",
"label": "Old address redirects",
"state": "todo"
}
],
"subject": null,
"summary": "Primary URL",
"to_version": null,
"type": "url_change",
"type_label": "Primary URL"
}
],
"next_cursor": null
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"message": "Not found."
}{
"code": "invalid",
"errors": {
"cursor": [
"That page does not exist. Reload the list."
]
},
"field": "cursor",
"message": "That page does not exist. Reload the list.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}