List an environment's firewall activity
Answers every firewall change that reaches the environment, at any level, newest first. Paged by cursor: send next_cursor back as cursor; null means the last page.
Path parameters
The id of a CoreStack Enterprise environment. Not the same number as a site row id. At least 1.
Query parameters
The next_cursor of the previous answer. A value of more than 200 characters is refused 422 invalid_arguments on cursor; any other value the list did not give you is ignored and answers the first page.
Returns
200 A page of activity.
Fields of the 200 answer
Send as cursor to read the next page. Null on the last page.
Fields of each item
entry_addedentry_updatedentry_removedentry_expiredrange_requestedrange_approvedrange_rejectedpreset_attachedpreset_detachedappliedapply_failedWho added an address or made a change.
Fields
Null when the person has been removed, or when Corefinity support added the address.
The person Corefinity support added it for.
True when Corefinity support added the address for a customer.
Format: date-time.
Where the change was made, such as ui (the Control Panel), api or mcp.
uiapimcpcliimportsystemstaffThe address the event is about, when it is about one.
agencycompanywebsiteenvironmentuserpresethttp_auth_rulenullIf it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | scope_required | Use a token with the scope named in scope. |
404 | feature_off | This feature is not on for your organisation yet. |
404 | not_found | Not found. |
422 | invalid_arguments | The 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. |
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/environments/1311/firewall/activity \
-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/environments/1311/firewall/activity');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/environments/1311/firewall/activity', {
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/environments/1311/firewall/activity",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"events": [
{
"action": "preset_attached",
"actor": {
"name": "Eleanor Finch",
"on_behalf_of": null,
"support": false
},
"at": "2026-11-06T09:18:02.000Z",
"channel": "api",
"cidr": null,
"layer": "company",
"owner": {
"id": 1204,
"name": "Harbour & Finch",
"type": "company"
},
"reason": null
},
{
"action": "entry_added",
"actor": {
"name": "Eleanor Finch",
"on_behalf_of": null,
"support": false
},
"at": "2026-11-06T09:16:40.000Z",
"channel": "ui",
"cidr": "203.0.113.7/32",
"layer": "company",
"owner": {
"id": 1204,
"name": "Harbour & Finch",
"type": "company"
},
"reason": null
}
],
"next_cursor": null
}{
"message": "Unauthenticated."
}{
"code": "scope_required",
"message": "This access token does not have the destructive scope this needs. Use a token with the destructive scope.",
"reason": "scope_required",
"scope": "destructive"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "invalid_arguments",
"errors": {
"cursor": [
"Some of the details are missing or not valid."
]
},
"field": "cursor",
"message": "Some of the details are missing or not valid.",
"reason": "invalid_arguments"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}