Revert a Playground agent run’s canvas changes
playground_run_revertUndo every canvas change one agent run made, newest first, as one new revision. If someone has edited those nodes since, nothing changes and the conflicting node/edge IDs are returned; pass force=true only after confirming the later edits may be discarded. Generated media and credits are not refunded by a revert. Returns revert status, revision and any conflicting or overridden changes.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>",
"runId": "<runId>",
"expectedRevision": "<expectedRevision>",
"idempotencyKey": "<idempotencyKey>"
},
"name": "playground_run_revert"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | Whether to override detected conflicts while reverting; use only when the user intends to overwrite those later changes. | |
| runId | Yes | Run ID returned by preparation or execution for this project. | |
| projectId | Yes | ID of the Playground project chosen for this task; obtain it from project creation, an explicit project link or current context. | |
| idempotencyKey | Yes | Unique key for this request; reuse only when retrying the identical request after a lost response. Use a new key after quoting or changing inputs. | |
| expectedRevision | Yes | Current canvas revision from canvas_read; on revision_conflict, read again and rebuild the change. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| runId | No | ||
| status | Yes | ||
| replayed | Yes | ||
| revision | Yes | ||
| conflicts | No | ||
| overrodeConflicts | No | ||
| revertedRevisions | No |