# terrain.edit

> Talos next · Since next

[editor or disk] Change one op (set, enabled) or the surface; answers as terrain.apply.

| | |
|---|---|
| Title | Edit a terrain op |
| Mode |  |
| Token cost | about 128 tokens (listed only when its toolset is enabled) |
| Toolset | `terrain` |

## Arguments

| Argument | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `apply` | `boolean` | no |  |  | `false` writes nothing and reports what would change. |
| `enabled` | `boolean` | no |  |  | false: skip the op |
| `id` | `string` | no |  |  |  |
| `image` | `boolean` | no |  |  | `false` leaves the picture out of the answer. |
| `preview` |  | no |  |  | `false`, a view, or an object of `terrain.preview`'s arguments. |
| `set` | `object` | no |  |  | {field: value}; null removes |
| `surface` | `object` | no |  |  |  |
| `terrain` | `string` | no |  |  | The `.terrain.json` file to act on. The project's only terrain when absent. |

## Example

An MCP `tools/call` with the required arguments (placeholders in angle brackets).

```json
{
  "name": "terrain.edit",
  "arguments": {}
}
```