---
title: capacity_update
url: "/docs/ai-agents/mcp-tools/capacity/capacity_update/"
canonical_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/capacity/capacity_update/
markdown_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/capacity/capacity_update.md
summary: 'Change how much Capacity an Account keeps: reservation mode (on_demand,
  automatic or custom), reserved room, ceiling or idle retention.'
categories:
- mcp
- reference
---

# capacity_update

Change how much Capacity an Account keeps: reservation mode (on_demand, automatic or custom), reserved room, ceiling or idle retention. A change that needs review returns what it does; call again with yes: true once the person agrees.

| | |
|---|---|
| Access | Changes Blossom |
| Same as | [`blossom capacity:update`](/docs/reference/cli/capacity/update/) |

## Arguments

| Argument | Type | Description |
|---|---|---|
| `id` | string | Capacity id. Required. |
| `data` | object | Only the fields to change, as in capacity.yml from capacity:init. Required. |
| `data.reservation_mode` | string | on_demand, automatic or custom. |
| `data.reserved` | object | Room to keep, for custom. |
| `data.ceiling` | object | Most room to allocate. |
| `data.idle_retention_seconds` | integer | Keep excess Capacity this long after demand drops. |
| `yes` | boolean | true to apply a change that needs review, once the person agrees. |

## Example

```json
{"id":"capacity-100","data":{"clone_url":"https://github.com/acme/shop","services":[{"name":"web","command":"web","port":3000,"publicly_exposed":true}]}}
```