A mutation to create a new Milestone on a specific Roadmap.
As with in-app behaviour, you must specify a summary (Milestone Name) when creating a new Milestone. Given that Milestones are associated with a single, specific roadmap, a roadmapID must also be specified in order to create a new Milestone. All other fields are optional.
A Milestone can only have a single date. It cannot include dates ranges (Start and End Dates) or a bucket time.
Sample Mutation
// Create milestone mutation
mutation {
createMilestone (
roadmapID: "5e4d7d53caec436c46595378"
summary: "Boxing Day Event"
description: "Boxing Day Door Crashers"
date: "December 26, 2020"
milestoneType: "launch"
fields: [{
id: "5e4d7d53caec436c465953bc"
value : "Milestones"
}, {
id: "5e4d7d53caec436c465953cd"
value : "Target Date"
}]
){
id
summary
description
date
account {
companyName
billingFirstName
billingLastName
}
roadmap {
id
title
fiscalEndMonth
}
fields {
...on ItemField {
fieldID
fieldName
}
}
}
}
Sample Response
// Create milestone mutation successful result
{
"data": {
"createMilestone": {
"id": "5e4dd01a930df2f65c39a723",
"summary": "Boxing Day Event",
"description": "Boxing Day Door Crashers",
"date": "2020-12-26",
"account": {
"companyName": "Roadmunk",
"billingFirstName": "John",
"billingLastName": "Smith"
},
"roadmap": {
"id": "5e4d7d53caec436c46595378",
"title": "Ecommerce Roadmap",
"fiscalEndMonth": "December"
},
"fields": {
"page": [
{
"fieldID": "5e45e4bb8bc5675dc500a37e",
"fieldName": "Milestone Type"
},
{
"fieldID": "5e4d7d53caec436c465953bc",
"fieldName": "Theme (Ecommerce Roadmap)"
},
{
"fieldID": "5e4d7d53caec436c465953cd",
"fieldName": "Owner (Ecommerce Roadmap)"
}
]
}
}
}