---
title: "corestack_firewall_entry_update"
url: https://docs.corefinity.com/mcp/tools/corestack_firewall_entry_update
type: tool
last_updated: 2026-11-13
feature: firewall
related:
  - https://docs.corefinity.com/api/reference/firewall/update-firewall-entry.md
  - https://docs.corefinity.com/guides/sites/access-and-security/firewall.md
---
# corestack_firewall_entry_update

**Change a firewall address.** Change a firewall address's comment, expiry or scope (SSH, website or both). Scope: write. Long-running: answers with a task.

- Scope: `write`
- Runs as a task: yes

## When to use it

Change an address's comment, expiry (null for none) or scope. An address your agency added is read-only to its clients.

## Inputs

- `entry_id` (integer, required)
- `comment` (string or null)
- `expires_in_days` (1, 30, 90, 365 or null)
- `scope` (string): `both`, `ssh` or `web`

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "comment": {
      "description": "A note shown beside the address (at most 200 characters).",
      "maxLength": 200,
      "type": [
        "string",
        "null"
      ]
    },
    "entry_id": {
      "minimum": 1,
      "type": "integer"
    },
    "expires_in_days": {
      "description": "Days from now (1, 30, 90 or 365); null for no expiry. Leave it out to keep the current expiry.",
      "enum": [
        1,
        30,
        90,
        365
      ],
      "type": [
        "integer",
        "null"
      ]
    },
    "scope": {
      "description": "What the address may reach: both (default), ssh only or web only (the website's HTTP authentication and maintenance page).",
      "enum": [
        "both",
        "ssh",
        "web"
      ],
      "type": "string"
    }
  },
  "required": [
    "entry_id"
  ],
  "type": "object"
}
```

## Refusals

- `managed_elsewhere` (message: "This site is managed by another control panel"): another control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).
- `switched_off`: the firewall is not available for this object yet.
- `firewall_not_editable`: you can see this address but not change it.
- `firewall_state_conflict`: it changed — read it again.

## Example

```json
{
  "name": "corestack_firewall_entry_update",
  "arguments": {
    "entry_id": 9001,
    "comment": "Home office"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_firewall_entry_update with entry_id 9001, comment Home office. (Change a firewall address.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [PATCH /api/firewall/entries/{entry}](https://docs.corefinity.com/api/reference/firewall/update-firewall-entry.md)
- Guide: [Firewall](https://docs.corefinity.com/guides/sites/access-and-security/firewall.md)
