Create a roadmap project

Create a roadmap project

Request Body — REQUIRED
title string — REQUIRED Title of the project
caption string Caption / subtitle
publicDescription string Public description (visible on public views)
privateDescription string Private description (internal)
assigneeIds string[] IDs of assignees. Only collaborators are accepted, others are silently skipped.
linkedDiscoveryIds string[] IDs of discoveries to link. Only discoveries (not components) are accepted, others are silently skipped.
fieldsOptions string[] IDs of custom field options to assign. Server resolves field parent automatically. For SINGLE_SELECT fields, only the first option is kept.

Responses

201 Create a new roadmap project Schema — OPTIONAL roadmapProject object The created roadmap project id string Unique identifier of the roadmap project clientId string Client identifier createdAt date-time Creation date updatedAt date-time Last update date title string Title of the project caption string — OPTIONAL Caption / subtitle publicDescription string — OPTIONAL Public description privateDescription string — OPTIONAL Private description coverImage string — OPTIONAL Cover image URL coverImageThumbnail string — OPTIONAL Cover image thumbnail URL progress object Progress calculated from linked discoveries started number Ratio of started discoveries (excl. CLOSED) finished number Ratio of finished discoveries (excl. CLOSED) assignees object[] Assignees of the project id string Unique identifier of the assignee email string — OPTIONAL Email of the assignee name string Name of the assignee fields object[] — OPTIONAL Custom field values. Only included when select=fields is specified. field object The custom field definition id string Field ID clientId string Field client ID name string Field name type string Possible values: [SINGLE_SELECT, MULTI_SELECT] Field type singleValue object — OPTIONAL Selected option (SINGLE_SELECT fields) id string Option ID clientId string Option client ID name string Option name multiValues object[] — OPTIONAL Selected options (MULTI_SELECT fields) id string Option ID clientId string Option client ID name string Option name linkedDiscoveries object[] — OPTIONAL Linked discoveries. Only included when select=discoveries is specified. id string Discovery ID clientId string Discovery client ID title string Discovery title discoveryStateId string — OPTIONAL Current discovery state ID votes object[] — OPTIONAL Votes. Only included when select=votes is specified. id string Vote ID value string Possible values: [BAD, NULL, GOOD] Vote value personId string — OPTIONAL Person ID of the voter email string — OPTIONAL Email of the voter createdAt date-time Date of the vote warnings string[] Warnings from silent validation