---
title: capacity_retire
url: "/docs/ai-agents/mcp-tools/capacity/capacity_retire/"
canonical_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/capacity/capacity_retire/
markdown_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/capacity/capacity_retire.md
summary: Retire idle Capacity now instead of after its warm period, such as an idle
  Builder.
categories:
- mcp
- reference
---

# capacity_retire

Retire idle Capacity now instead of after its warm period, such as an idle Builder. Refused while it is in use or has a minimum.

| | |
|---|---|
| Access | Deletes; asks for `yes: true` |
| Same as | [`blossom capacity:retire`](/docs/reference/cli/capacity/retire/) |

## Arguments

| Argument | Type | Description |
|---|---|---|
| `id` | string | Capacity id. Required. |
| `yes` | boolean | true once the person confirms. Required. |

## Example

```json
{"id":"capacity-100","yes":true}
```