---
title: builder_update
url: "/docs/ai-agents/mcp-tools/builders/builder_update/"
canonical_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/builders/builder_update/
markdown_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/builders/builder_update.md
summary: Change a Builder's name, size, timeout or idle retention, or make it the
  region's default.
categories:
- mcp
- reference
---

# builder_update

Change a Builder's name, size, timeout or idle retention, or make it the region's default.

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

## Arguments

| Argument | Type | Description |
|---|---|---|
| `id` | string | Builder id. Required. |
| `data` | object | Only the Builder fields to change. Required. |
| `data.name` | string | Builder name. |
| `data.timeout_seconds` | integer | Longest build. |
| `data.idle_retention_seconds` | integer | How long it stays warm after a build. |
| `data.size_unit_count` | integer | Size in units. |
| `data.default` | boolean | The region's default Builder. |
| `data.volume_gib` | integer | Build cache size. |

## Example

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