# willo_roadmap_write

> Change the roadmap: update one item (item_id from willo_roadmap: status, scores, order), add tasks (items), or add milestones (milestones)…

Generated from Willo's code at each release.

Source: https://www.willo.ai/docs/reference/mcp-tools/willo_roadmap_write

**Update the roadmap.** Change the roadmap: update one item (`item_id` from willo_roadmap: status, scores, order), add tasks (`items`), or add milestones (`milestones`) — exactly one per call. Willo's records, not the site. No card.

## Access

- **Token**: read + act, and editor access or higher on the business.
- **Approval**: Only when Willo's chat would stop for the same action. The description says when; otherwise the call runs at once.
- **Secret scan**: refused if the new content holds a value shaped like an API key or token.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `item_id` | string | no | The roadmap item to update. |
| `status` | string (planned or ready or skipped) | no | With item_id: new status. |
| `impact_score` | number | no | With item_id: 1–10. |
| `effort_score` | number | no | With item_id: 1–10. |
| `sort_order` | integer | no | With item_id: display order. |
| `items` | object[] | no | New tasks: {title, description, category, milestone_title?, estimated_start?, estimated_end?, …}. |
| `milestones` | object[] | no | New milestones: {title, description?, target_date?, milestone_type?, linked_goal_id?}. |

## Related

- [All MCP tools](https://www.willo.ai/docs/reference/mcp-tools)
- [Error codes](https://www.willo.ai/docs/reference/errors)
- [Draft and live](https://www.willo.ai/docs/ai-agents/draft-and-live)