Docs: Tool reference
planning toolset

save_roadmap

Create or update a roadmap. Creates an internal roadmap (omit id) or renames or redescribes one (pass id). A new roadmap starts empty with one scoring factor, Votes; add posts with add_to_roadmap and factors with configure_scoring. Names are unique. Nobody is emailed. Managers and owners.

Toolset
planning
Who can call it
OwnersManagersAPI keys
REST
POST /api/v1/w/{workspace}/roadmaps
Behavior
changes dataidempotentaccepts idempotency_key

Input

FieldTypeDescription
idstringThe roadmap's ID or name, to update it.
namestring
descriptionstring or null
expected_versionintegerThe roadmap's version from your last read; the call fails if it changed since.
idempotency_keystringRetry-safe key. Repeating a call with the same key returns the first result.

Output

FieldTypeDescription
roadmaprequiredobject
createdrequiredboolean

Calling it

// MCP: tools/call
{ "name": "save_roadmap", "arguments": {} }

// Typed client
await carechannel.save_roadmap({});