---
title: "corestack_environment_resize"
url: https://docs.corefinity.com/mcp/tools/corestack_environment_resize
type: tool
last_updated: 2026-11-13
feature: environments
related:
  - https://docs.corefinity.com/api/reference/environments/update-site-environment.md
  - https://docs.corefinity.com/guides/sites/environments-and-copies/create-an-environment.md
---
# corestack_environment_resize

**Resize a staging environment.** Change the size of a CoreStack site's staging environment, now or tonight. Sizes and prices: corestack_uat_sizes_list and corestack_billing_catalogue_get; price it first with corestack_billing_quote_preview. Scope: write. Long-running: answers with a task.

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

## When to use it

Change the size of a CoreStack site's staging environment, now or tonight. Sizes and prices: corestack_uat_sizes_list and corestack_billing_catalogue_get; price it first with corestack_billing_quote_preview.

## Inputs

- `site_id` (integer, ≥ 1, required): The staging environment's row.
- `uat_size` (string, up to 16 characters, required): A staging size key from corestack_uat_sizes_list.
- `apply` (one of `now`, `tonight`, default `"now"`): now (the default) or tonight, in the maintenance window, with everything else queued for the row.
- `quote_id` (string, pattern `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$`): A quote from corestack_billing_quote_preview (optional): the write refuses with stale if the price moved.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "apply": {
      "default": "now",
      "description": "now (the default) or tonight, in the maintenance window, with everything else queued for the row. window: the row's next maintenance window (tonight is kept as its alias).",
      "enum": [
        "now",
        "window",
        "tonight"
      ],
      "type": "string"
    },
    "quote_id": {
      "description": "A quote from corestack_billing_quote_preview (optional): the write refuses with stale if the price moved.",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "type": "string"
    },
    "site_id": {
      "description": "The staging environment's row.",
      "minimum": 1,
      "type": "integer"
    },
    "uat_size": {
      "description": "A staging size key from corestack_uat_sizes_list.",
      "maxLength": 16,
      "type": "string"
    }
  },
  "required": [
    "site_id",
    "uat_size"
  ],
  "type": "object"
}
```

## Refusals

- `included_size`: the size is the one already included in the package; nothing to buy.
- `contract_missing`: the billing contract changed while the change was being made; read the options again and call again. (A site or cluster with no billing contract is changed all the same, without a quote: it is not billed in the Control Panel.)
- `stale`: the quote no longer matches this change or has expired; preview a new one with corestack_billing_quote_preview and call again with its quote_id.
- `no_payment_method`: the company has no payment method; the person must add one in the Control Panel.
- `change_pending`: a change is already pending for this row; apply or cancel it first (corestack_pending_changes_list).
- `feature_off`: an input needs a feature that is switched off (for example `apply: "tonight"` while the maintenance window queue is switched off); leave that input out.
- `billing_forbidden`: the person has no billing role in the company; ask a company owner or billing member.
- `search_too_small`: search needs at least 8 GB; turn search off first or choose Medium (8 GB) or larger.
- `forbidden`: the Control Panel refuses this person the action and names no reason; stop.
- `demo_keep_required`: the site or cluster is a free demo that is not kept yet, and a bigger staging environment costs money: it starts once the demo is kept. Ask the person to keep it (`corestack_demo_keep`, or open `keep_url`); `change` names this change and what it would cost a month once kept.
- `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).

## Example

```json
{
  "name": "corestack_environment_resize",
  "arguments": {
    "site_id": 4211,
    "uat_size": "xsmall"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_environment_resize with site_id 4211, uat_size xsmall. (Resize a staging environment.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [PATCH /api/corestack/sites/{site}/environment](https://docs.corefinity.com/api/reference/environments/update-site-environment.md)
- Guide: [Create an environment](https://docs.corefinity.com/guides/sites/environments-and-copies/create-an-environment.md)
