# build.apply

> Talos next · Since next

Turn files changed outside the workspace API (a save is one) into a revision; wait until its build is Ready (and in the editor) or failed (build.state).

Concurrent applies all get the newest revision's build (builtRevisionId); a red build in files you did not apply says so (yourFilesOk, blockedBy). A group of several files waits for somebody to vouch the edit is finished.

| | |
|---|---|
| Title | Apply changes |
| Mode | `service` |
| Token cost | about 180 tokens (in the default list, paid on every call) |
| Toolset | core |

## Arguments

| Argument | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `agent` | `string` | no |  |  | The name of the agent making the call, when several agents share one connection: each named agent is its own actor and plays its own game. Leave it out when there is one agent. |
| `groupId` | `string` | no |  |  | A build.status pendingExternal group; absent: the waiting one |
| `timeoutSeconds` | `integer` | no |  |  |  |
| `wait` | `boolean` | no |  |  |  |

## Example

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

```json
{
  "name": "build.apply",
  "arguments": {}
}
```