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.
fieldsDates object[] Set DATE_ABSOLUTE custom field values. Each entry targets one field. Send date: null to leave it cleared. Non-DATE_ABSOLUTE or unknown fields are silently skipped with a warning. fieldId string — REQUIRED ID or clientId of the DATE_ABSOLUTE custom field date string — REQUIRED ISO-8601 date to set, or null to clear the value

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, DATE_ABSOLUTE] 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 dateValue date-time — OPTIONAL Selected date (DATE_ABSOLUTE fields) 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