Roadmap boards

Containers that group roadmap posts. Each organization can have multiple roadmap boards (e.g. Product, Platform).

A roadmap board is a container that groups roadmap posts (planned work, in-flight initiatives, shipped milestones). Roadmap boards are distinct from feedback boards — feedback represents user requests, roadmap represents what your team is doing.

The API lets you list and retrieve roadmap boards. Creating, updating, and deleting boards is dashboard-only in v1.

The roadmap board object

idstring

Required

A unique identifier for the board (UUID).

namestring

Required

The display name of the board (e.g. "Product Roadmap").

slugstring

Required

URL-safe slug derived from the name (e.g. "product-roadmap").

descriptionstring

Optional human-readable description shown in the dashboard. May be null.

icon_urlstring

Optional URL of an icon image displayed alongside the board name. May be null.

created_atstring

Required

ISO 8601 timestamp at which the board was created.

Example roadmap board object

{
  "id": "553c3ef8-b8cd-cd15-01ba-roadmap0001",
  "name": "Product Roadmap",
  "slug": "product-roadmap",
  "description": "Public-facing roadmap for our customer-facing product.",
  "icon_url": null,
  "created_at": "2026-04-01T08:00:00.000Z"
}

What you can do

Retrieve a board

Look up a single roadmap board by its UUID.

List boards

Return every active roadmap board for the authenticated organization.

Was this page helpful?

Last updated 1 week ago

Built with Documentation.AI