---
title: "corestack_company_restores_list"
url: https://docs.corefinity.com/mcp/tools/corestack_company_restores_list
type: tool
last_updated: 2026-11-13
feature: restores
related:
  - https://docs.corefinity.com/guides/sites/backups/restore-anywhere.md
---
# corestack_company_restores_list

**Your company's restores.** The restores into your company's websites and environments in the last 90 days, newest first, 50 a page: what was restored where, by whom, how it ended, its safety copy and whether it can still be undone. Scope: read.

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

## When to use it

Read your company's restore history: the restores into its websites and environments in the last 90 days, newest first, 50 a page. Each one shows what kind of restore it was, its status and outcome, the reason a failed one gives, who asked for it and how long it took, the snapshot it came from (null once that row is gone, or when your token's pins do not cover it), where it went, its safety copy, and whether it can still be undone and until when. A restore Corefinity support made from another company shows as made by Corefinity support.

## Inputs

- `site_id` (integer, optional): a website: its production row and its environments.
- `environment_id` (integer, optional): one environment.
- `kind` (string, optional): `in_place`, `new_environment`, `existing_environment`, `production` or `new_site`.
- `cursor` (string, optional): the `next_cursor` of the page before; null there means the last page.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "cursor": {
      "maxLength": 512,
      "type": "string"
    },
    "environment_id": {
      "minimum": 1,
      "type": "integer"
    },
    "kind": {
      "enum": [
        "in_place",
        "new_environment",
        "existing_environment",
        "production",
        "new_site"
      ],
      "type": "string"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "type": "object"
}
```

## Refusals

- `invalid_arguments`: a cursor that is not one of ours; start again from the first page.
- 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_company_restores_list",
  "arguments": {
    "site_id": 300,
    "kind": "new_environment"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_company_restores_list with site_id 300, kind new_environment. (Your company's restores.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [Restore anywhere](https://docs.corefinity.com/guides/sites/backups/restore-anywhere.md)
