POST/roadmaps

Create a roadmap

Create a new roadmap

Request body

Field	Type	Description
`name`required	`string`	Roadmap name
`slug`required	`string`	URL-friendly slug
`description`	`string`	Roadmap description
`type`	`"column" \| "date"`
`baseFilter`	`object`
`dateSource`	`"eta" \| null`
`frequency`	`"monthly" \| "quarterly" \| "semiannual" \| null`
`visibility`	`"public" \| "team" \| "segment"`
`isPublic`	`boolean`	Deprecated: use `visibility`. `false` maps to `team`, `true` maps to `public`. Ignored when `visibility` is sent.
`visibleSegmentIds`	`string[] \| null`
`columns`	`object[]`

Response

Roadmap created

Field	Type	Description
`id`required	`string`	TypeID - a type-prefixed UUID
`name`required	`string`
`slug`required	`string`	URL-friendly identifier
`description`required	`stringnull`
`type`required	`"column" \| "date"`
`baseFilter`required	`object`
`dateSource`required	`"eta" \| null`
`frequency`required	`"monthly" \| "quarterly" \| "semiannual" \| null`
`visibility`required	`"public" \| "team" \| "segment"`
`visibleSegmentIds`required	`string[] \| null`
`position`required	`number`	Display order
`columns`required	`object[]`
`createdAt`required	`string`	ISO 8601 timestamp

Errors

400Validation error

401Unauthorized

Example request

curl \
  -X POST \
  "https://feedback.quackback.io/api/v1/roadmaps" \
  -H "Authorization: Bearer qb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Product Roadmap",
  "slug": "product-roadmap",
  "description": "example_description",
  "type": "example_type",
  "visibility": "example_visibility",
  "isPublic": false,
  "columns": []
}'