Add a milestone to a project (desk:write)
POST /api/desk/v1/projects/{id}/milestones
Module: Desk · operationId: createProjectMilestone · Tag: Projects · Auth: access token (Authorization: Bearer <accessToken>)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string | yes |
Request body
application/json (required)
completion(string): manual: achieved by hand; items: reached once all its items are done (one ofmanual,items)description(string): Description of the milestonedueOn(string (date)): Due dateposition(integer): Position among the project's milestonestitle(string): Title of the milestoneversion(integer): Required on change
Example:
{
"completion": "manual",
"description": "Versand und Spediteur sind angebunden und getestet.",
"dueOn": "2026-11-20",
"title": "Schnittstellen abgenommen"
}
Responses
- 201 Milestone (
application/json)
Fields of the 201 answer:
achievedAt(string (date-time), nullable, read-only): When the milestone was reachedachievedBy(string, read-only): The person, or system for completion by itemscompletion(string): manual: achieved by hand; items: reached once all its items are done (and open again when one reopens) (one ofmanual,items)contractId(string, read-only): Contract of a contract batch (empty otherwise)customerId(string, read-only): The invoice's customerdescription(string): Description of the milestonedueOn(string (date)): Due dateid(string, read-only): Id of the milestoneitems(integer, read-only): Visible items of the milestone (plan only)itemsDone(integer, read-only): Visible items of the milestone that are done (plan only)label(string, read-only): The unit as the invoice names it (project, contract, customer name)position(integer): Position among the project's milestonesprojectId(string, read-only): Project of a project batch (empty otherwise)scope(string, read-only): (one ofproject,contract,customer)title(string): Title of the milestone (max length 200)version(integer): Version of the milestone; send it back on change
Example 201 answer:
{
"achievedAt": "2026-11-10T16:00:00Z",
"achievedBy": "system",
"completion": "items",
"description": "Key-User haben die Konfiguration abgenommen.",
"dueOn": "2026-11-11",
"id": "6c3d4e5f-7a8b-4c9d-8e1f-3a4b5c6d7e02",
"items": 5,
"itemsDone": 5,
"label": "ERP-Einführung Donau Maschinenbau",
"position": 1,
"projectId": "5b2c3d4e-6f7a-4b8c-9d0e-2f3a4b5c6d01",
"scope": "project",
"title": "Konfiguration abgenommen",
"version": 2
}
Example request
curl -X POST 'https://api.mbcom.cloud/api/desk/v1/projects/string/milestones' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"completion":"manual","description":"Versand und Spediteur sind angebunden und getestet.","dueOn":"2026-11-20","title":"Schnittstellen abgenommen"}'