Docs: Tool reference
planning toolset

add_to_roadmap

Add posts to a roadmap. Adds posts to an internal roadmap by post_ids or a filter (up to 200 per call; a roadmap holds 1000) and scores them. Posts already on it are left alone; a post removed earlier comes back with its manual factor values. Use a filter like {"not":{"field":"on_roadmap","op":"eq","value":"Q1"}} to skip ones already there. Nobody is emailed. Managers and owners.

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

Input

FieldTypeDescription
roadmaprequiredstringThe roadmap's name or ID (rdm_…).
post_idsarray of stringPost IDs or slugs, up to 200.
filterobjectOr a post filter (DSL, as in search_posts) matching at most 200 posts.

Output

FieldTypeDescription
roadmaprequiredobject
addedrequiredarray of string
already_onrequiredarray of string

Calling it

// MCP: tools/call
{ "name": "add_to_roadmap", "arguments": {"roadmap":"<string>"} }

// Typed client
await carechannel.add_to_roadmap({"roadmap":"<string>"});