Create or update a roadmap. Creates an internal roadmap (omit id) or renames or redescribes one (pass id). A new roadmap starts empty with one scoring factor, Votes; add posts with add_to_roadmap and factors with configure_scoring. Names are unique. Nobody is emailed. Managers and owners.
Toolset
planning
Who can call it
OwnersManagersAPI keys
REST
POST /api/v1/w/{workspace}/roadmaps
Behavior
changes dataidempotentaccepts idempotency_key
Input
Field
Type
Description
id
string
The roadmap's ID or name, to update it.
name
string
description
string or null
expected_version
integer
The roadmap's version from your last read; the call fails if it changed since.
idempotency_key
string
Retry-safe key. Repeating a call with the same key returns the first result.