Skip to main content
TroopyDocs
GuidesSet up and use TroopyAppsConnect your servicesAPIThe API, the CLI and MCPChangelogEach update to Troopy

Developers

Account

Troop

Skills

Tasks and projects

Needs you

Routines and triggers

Brain

Docs

Canvas

Email

CRM

Outreach

Customers

Analytics

Sessions

Surveys

Support Agent

Tests and incidents

Disputes

Apps

Vault

Computer

Open Troopy
Troopy

API reference / Customers

Change an item of the roadmap

Changes the title, the note or the status of an item. Send only what changes.

patch/api/v1/roadmap/{id}

Authorization

HeaderAuthorization: Bearer <API key>
Or the headerX-API-Key: <API key>
API keyMake one in Troopy under Settings > API keys. It acts as you, in its workspace.
Scopescustomers:write

Other ways to call it

CLItroopy roadmap set
MCP toolNone. Call it over REST or with the CLI.
Rate limit60 calls in 60 seconds, for each key

Path parameters

id*string

A 24-character id

Body

application/json
titlestring

At least 2 characters · At most 120 characters

notestring

At most 2000 characters

statusenum<string>

ideaplannedbuildingshippeddeclined

Response

200 · application/json
data*object
9 properties
id*string

A 24-character id

title*string
note*string | null

What the item is and why, in the words of the business

status*enum<string>

ideaplannedbuildingshippeddeclined

task*string | null

The key of the task that builds it

evidence*object

Who asked for it

4 properties
pieces*integer

The pieces of feedback that speak for it

customers*integer

The customers who said them

mrr*number

What those customers pay for a month now, in the units of the currency

currency*string | null
by*object
2 properties
type*string
name*string | null
shippedAt*string | null
createdAt*string

ISO 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.
404 not_foundCheck the path and any id in it. Every operation is listed in /api/v1/openapi.json.
429 rate_limitedWait the number of seconds in Retry-After, then retry.