---
title: "corestack_nginx_rules_history_list"
url: https://docs.corefinity.com/mcp/tools/corestack_nginx_rules_history_list
type: tool
last_updated: 2026-11-13
feature: nginx-rules
related:
  - https://docs.corefinity.com/api/reference/site-settings/list-site-nginx-revisions.md
  - https://docs.corefinity.com/guides/sites/site-settings/web-server-rules.md
---
# corestack_nginx_rules_history_list

**nginx rules history.** List an environment row's nginx rules revisions, newest first: number, time, author (a person, an MCP token, Corefinity or an automatic revert), origin, status, note and the hooks each changed. Page with cursor. Scope: read.

- Scope: `read`
- Runs as a task: no

## When to use it

List an environment row's nginx rules revisions, newest first: number, time, author (a person, an MCP token, Corefinity or an automatic revert), origin, status, note and the hooks each changed. Page with cursor.

Each row: `id` (for corestack_nginx_rules_revision_get and corestack_nginx_rules_revert), `number`, `created_at`, `author` (`kind` `user`, `mcp_token`, `oauth`, `corefinity` or `automatic`, `name`, `client`), `origin`, `status` and `status_reason`, `note`, `hooks_changed`, `errors_since` (null when logs are not available). `next_cursor` is null on the last page.

## Inputs

- `site_id` (integer, ≥ 1, required): The environment row.
- `cursor` (string): next_cursor from the page before.
- `limit` (integer, 1 to 100): Revisions per page (default 20).

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "cursor": {
      "description": "next_cursor from the page before.",
      "maxLength": 20,
      "type": "string"
    },
    "limit": {
      "description": "Revisions per page (default 20).",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "site_id": {
      "description": "The environment row.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id"
  ],
  "type": "object"
}
```

## Refusals

- 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).

## Example

```json
{
  "name": "corestack_nginx_rules_history_list",
  "arguments": {
    "site_id": 4211,
    "limit": 10
  }
}
```

## Path apps

A revision that changed the environment's path apps or gates names `path_apps` in `hooks_changed`, beside the hooks it changed; a revision that changed only their labels or presets names it too (nothing was committed for it). Read a revision's list, and its diff, with corestack_nginx_rules_revision_get.

## Prompt

```text
Using the Corefinity MCP server, call corestack_nginx_rules_history_list with site_id 4211, limit 10. (nginx rules history.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/corestack/sites/{site}/nginx-rules/revisions](https://docs.corefinity.com/api/reference/site-settings/list-site-nginx-revisions.md)
- Guide: [Web server rules](https://docs.corefinity.com/guides/sites/site-settings/web-server-rules.md)
