get_roadmap_legends
Retrieve the legend names (bar colors) available on a roadmap to identify which legend to use when coloring bars.
Instructions
Get the legend names (bar colors) for a roadmap.
USE WHEN: "What colors are available?", "Show the legend", "Which legend can I color bars with?"
Returns an array of legend names. The ProductPlan API exposes legends by name only: there is no legend ID or hex color to return. Pass a name as legend on manage_bar, bulk_update_bars, or bulk_create_bars to color a bar.
For custom field definitions (labels, dropdown allowed_values), use get_roadmap instead. To find bars by legend, use get_roadmap_bars with legend.
FAILS WHEN: roadmap_id not found (use list_roadmaps).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"roadmap_id": "<roadmap_id>"
},
"name": "get_roadmap_legends"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| roadmap_id | Yes | Roadmap ID |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | The ProductPlan payload (object or array) returned by the API, passed through verbatim | |
| summary | Yes | Human-readable summary of the result (e.g. "Found 3 roadmaps") |