Docs: Tool reference
planning toolset

rank_roadmap_post

Rank a post on a roadmap. Moves a post within a roadmap's manual order, the order get_roadmap returns with sort manual. Pass one of position (1 is the top), before or after (another post on the roadmap, by ID or slug); the other posts keep their order. New posts join at the bottom. Scores don't change. Nobody is emailed. Managers and owners.

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

Input

FieldTypeDescription
roadmaprequiredstringThe roadmap's name or ID (rdm_…).
postrequiredstringThe post to move, by ID or slug.
positionintegerIts new rank; 1 is the top.
beforestringOr: place it just above this post (ID or slug).
afterstringOr: place it just below this post (ID or slug).

Output

FieldTypeDescription
roadmaprequiredobject
postrequiredobject
positionrequiredintegerIts rank now, from 1.
previous_positionrequiredinteger
totalrequiredintegerPosts in the manual order.

Calling it

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

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