build.apply
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).
{
"name": "build.apply",
"arguments": {}
}