Skip to content

Milestones & Phases · Troubleshooting

Symptom Likely cause Resolution
404 {"error": "No PI board found with the given ID."} The ID was copied from the browser URL, or the API user cannot open the board's collection Take {boardId} from GET /api/v1/boards. Open the board in Kendis as the same user to confirm access.
404 on /milestones/{keyOrId} The milestone or phase is not linked to this board, or an objective / key result key was used Use a key or id from this board's /milestones
400 "type must be one of: all, milestones, phases" Unknown type value Use all, milestones or phases
400 "Invalid value for parameter '…'" A paging value such as pageLimit or startAt is not a whole number Send whole numbers, e.g. pageLimit=50
Phases appear in the milestones list /milestones returns both by default Add ?type=milestones (or ?type=phases)
completionPct differs from what you expected A different completion method is selected on the milestone or phase Check criteria; all three methods are in completion
A Done story linked to a milestone doesn't raise children-based completion The children methods count sub-items only Expected; that story counts in byLinkedItemStatus only
Milestone date is a day early The epoch value was read in UTC Convert date in your own timezone
Milestones or phases missing from counts on the PI board summary They are not part of that summary Read total from /milestones
Parser finds no data key These routes use capital Data Read Data. GET /api/v1/boards uses lowercase data.
Only 50 rows returned pageLimit is capped at 50 Page with startAt until startAt + Data.length >= total
childrenSummary / children missing on linked cards expand not set Add ?expand=children