CorefinityCorefinityDocs
Open the Control PanelControl Panel
SSH keys · 5 of 14

List an environment's SSH activity

Answers what changed about SSH access to the environment, newest first, 50 a page: keys added, changed and removed at any level that reaches it, usernames issued, host keys rotated and changes applied. Paged by cursor: send next_cursor back as cursor; null means the last page.

GET/api/environments/{environment}/ssh/activity

Path parameters

environmentintegerRequired

The id of a CoreStack Enterprise environment. Not the same number as a site row id. At least 1.

Query parameters

cursorstring

The next_cursor of the previous answer, sent back as it was given. Anything else (a value that is not a cursor of these lists, or more than 200 characters) is refused 422 invalid_arguments on cursor.

Returns

200 A page of activity.

Fields of the 200 answer
next_cursorstring or nullRequired

Send as cursor to read the next page. Null on the last page.

eventsarray of objectsRequired
Fields of each item
actionstringRequired
key.addedkey.updatedkey.removedkey.quarantinedlegacy.importedlegacy.keptlegacy.placedlegacy.removedlegacy.cut_offlogin.issuedlogin.retiredhost_keys.adoptedhost_keys.stagedhost_keys.promotedhost_keys.rotated_nowhost_keys.abortedhost_keys.republisheddelivery.adopteddelivery.applieddelivery.failedrevocation.pendingrevocation.appliedrevocation.lifted
actorobject or any or nullRequired

Who did it. Null for the platform.

atstringRequired

Format: date-time.

channelstringRequired

Where the change was made, such as ui (the Control Panel), api or mcp.

uiapimcpcliimportsystemstaff
fingerprintstring or nullRequired

The key the event is about, when it is about one.

layerstring or nullRequired
agencycompanywebsiteenvironmentuserlegacysystemnull
loginstring or nullRequired
ownerobject or any or nullRequired
reasonstring or nullRequired

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403scope_requiredUse a token with the scope named in scope.
404feature_offThis feature is not on for your organisation yet.
404not_foundNot found.
422invalid_argumentsThe arguments do not match the tool's input schema, or the Control Panel refused a field. Fix the fields named in the answer and call again.
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/environments/1311/ssh/activity \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "events": [
    {
      "action": "delivery.applied",
      "actor": null,
      "at": "2026-11-05T09:17:02+00:00",
      "channel": "system",
      "fingerprint": null,
      "layer": null,
      "login": null,
      "owner": null,
      "reason": null
    },
    {
      "action": "key.added",
      "actor": {
        "former": false,
        "name": "Eleanor Finch",
        "support": false
      },
      "at": "2026-11-05T09:16:40+00:00",
      "channel": "api",
      "fingerprint": "SHA256:o6poLLVqPDVYtxLTdagh8mUo96coeRXfX7Uxorxr158",
      "layer": "company",
      "login": "web",
      "owner": {
        "id": 1204,
        "name": "Harbour & Finch",
        "type": "company"
      },
      "reason": null
    }
  ],
  "next_cursor": null
}
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