All MCP tools
MCP tools · Operator agents and approvals
update_operator_agent
Replaces an Operator agent's unpublished draft (its steps) with an edited one. The published version keeps running unchanged until a person publishes the draft in Finn. Read the agent first with get_operator_agent, edit its draft, and pass its draft_rev so a newer edit is never overwritten. Returns the saved steps and any problems to fix before it can be published.
- Scope needed
- operator:build
- Changes data
- Yes
- Held for approval
- No
- Available to
- Switched on per organization (MCP task tools and extra write tools)
Inputs
| Name | Type | Description |
|---|---|---|
| org_id | string | Organization id. Leave out when the user belongs to one organization; otherwise the error lists theirs. |
| agent_idrequired | string | The agent id (a UUID), from list_operator_agents. |
| draftrequired | object | The whole edited draft graph (`nodes` and `edges`), as get_operator_agent gave it with your changes. |
| draft_rev | number | The agent's draft_rev from get_operator_agent. If the draft changed since, nothing is saved. |