API reference / Customers
List the roadmap
What the business considers to build for its customers, each item with who asked for it: the pieces of feedback, the customers, and what those customers pay for a month. The items that most paying customers asked for come first within a status. It is for the business only: no customer sees it.
get
/api/v1/roadmapOther ways to call it
CLI
troopy roadmap listMCP tool
troopy_list_roadmapRate limit120 calls in 60 seconds, for each key
Query parameters
statusenum<string>ideaplannedbuildingshippeddeclined
Response
200 · application/jsondata*array<object>9 properties
id*stringA 24-character id
title*stringnote*string | nullWhat the item is and why, in the words of the business
status*enum<string>ideaplannedbuildingshippeddeclined
task*string | nullThe key of the task that builds it
evidence*objectWho asked for it
4 properties
pieces*integerThe pieces of feedback that speak for it
customers*integerThe customers who said them
mrr*numberWhat those customers pay for a month now, in the units of the currency
currency*string | nullby*object2 properties
type*stringname*string | nullshippedAt*string | nullcreatedAt*stringISO 8601 date and time
Errors
400 invalid_inputFix the field named in detail. Each operation's schema is in /api/v1/openapi.json.
401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask an organization owner or admin.
429 rate_limitedWait the number of seconds in Retry-After, then retry.