CorefinityCorefinityDocs
Open the Control PanelControl Panel
Sites · 2 of 18

Acknowledge an attention item

Marks an item as acknowledged for your company. It stays listed, stops counting as needing attention until it changes, and shows who acknowledged it. Acknowledging the same item again answers the same acknowledgement.

POST/api/corestack/attention/{attention}/ack

Path parameters

attentionstringRequired

The id of an item of the attention list, URL-encoded: a kind, a colon, a number and sometimes a further part, such as site_down:1051 (sent as site_down%3A1051).

Returns

200 The acknowledgement, and the parts of the overview it changed.

Fields of the 200 answer
acknowledgedobjectRequired
Fields
atstringRequired

Format: date-time.

byobject or any or nullRequired

Who acknowledged the item. Null when that person's account no longer exists.

since_atstring or nullRequired

Since when the item had been open when it was acknowledged. Format: date-time.

overview_patchobjectRequired

The parts of the overview an acknowledgement changed.

Fields
attentionarray of objectsRequired
Fields of each item
acknowledgeablebooleanRequired
acknowledgedobject or any or nullRequired
actionobject or null
clusterobject or any or null
detailstring or null
environmentobject or any or null
hrefstring or null

A path in the Control Panel.

idstringRequired

The stable item id, such as site_down:1051.

kindstringRequired
scopestring or null
severitystringRequired
sincestring or null

Format: date-time.

siteobject or any or null
subjectobject or null
titlestringRequired
attention_acknowledgedarray of objectsRequired
Fields of each item
acknowledgeablebooleanRequired
acknowledgedobject or any or nullRequired
actionobject or null
clusterobject or any or null
detailstring or null
environmentobject or any or null
hrefstring or null

A path in the Control Panel.

idstringRequired

The stable item id, such as site_down:1051.

kindstringRequired
scopestring or null
severitystringRequired
sincestring or null

Format: date-time.

siteobject or any or null
subjectobject or null
titlestringRequired
attention_acknowledged_totalintegerRequired
attention_totalintegerRequired
generated_atstringRequired

Format: date-time.

sites_attentionobjectRequired

How many items need attention for each site, keyed by site row id.

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.
404not_openThe attention item is no longer open. Read the list again.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl -X POST https://manage.corefinity.com/api/corestack/attention/site_down%3A1051/ack \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "acknowledged": {
    "at": "2026-11-14T09:01:00Z",
    "by": {
      "id": 2041,
      "name": "Eleanor Finch"
    },
    "since_at": "2026-11-14T08:58:00Z"
  },
  "overview_patch": {
    "attention": [],
    "attention_acknowledged": [
      {
        "acknowledgeable": true,
        "acknowledged": {
          "at": "2026-11-14T09:01:00Z",
          "by": {
            "id": 2041,
            "name": "Eleanor Finch"
          },
          "since_at": "2026-11-14T08:58:00Z"
        },
        "action": null,
        "cluster": {
          "id": 1017,
          "name": "Northwind UK 1"
        },
        "detail": "No container is ready.",
        "environment": null,
        "href": "/managed-clusters/sites/1051",
        "id": "site_down:1051",
        "kind": "site_down",
        "scope": "site",
        "severity": "critical",
        "since": "2026-11-14T08:58:00Z",
        "site": {
          "domain": "journal.harbourandfinch.example.com",
          "id": 1051
        },
        "subject": null,
        "title": "Site is down"
      }
    ],
    "attention_acknowledged_total": 1,
    "attention_total": 0,
    "generated_at": "2026-11-14T09:01:00Z",
    "sites_attention": {}
  }
}
Try it
Held in this tab's memory only. Never stored or sent to us.

This sends a real POST request and changes your account.

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

Was this helpful?
Open in ClaudeOpen in ChatGPT