---
title: environment_build_config_update
url: "/docs/ai-agents/mcp-tools/environments/environment_build_config_update/"
canonical_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/environments/environment_build_config_update/
markdown_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/environments/environment_build_config_update.md
summary: Change how an Environment builds, such as dockerfile or a Builder.
categories:
- mcp
- reference
---

# environment_build_config_update

Change how an Environment builds, such as dockerfile or a Builder. Applies on the next deploy.

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

## Arguments

| Argument | Type | Description |
|---|---|---|
| `id` | string | Environment id. Required. |
| `data` | object | How the Environment builds, as in build_config.yml. Required. |
| `data.build_type` | string | auto, buildpack, dockerfile, prebuilt or static. |
| `data.builder` | string | Builder choice. |
| `data.builder_id` | string | auto or a Builder id. |
| `data.image` | string | Image for build_type prebuilt. |
| `data.allow_app_capacity_fallback` | boolean | Build on App capacity when no Builder is free. |

## Example

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