ConnectCloud Developers

Take the achievement back; writes desk.project.milestone_reopened (desk:write)

POST /api/desk/v1/projects/{id}/milestones/{mid}/reopen

Module: Desk · operationId: reopenProjectMilestone · Tag: Projects · Auth: access token (Authorization: Bearer <accessToken>)

Parameters

Name In Type Required Description
id path string yes
mid path string yes

Responses

  • 200 Milestone (application/json)
  • 409 milestone_state: not reached, or completed by its items

Fields of the 200 answer:

  • achievedAt (string (date-time), nullable, read-only): When the milestone was reached
  • achievedBy (string, read-only): The person, or system for completion by items
  • completion (string): manual: achieved by hand; items: reached once all its items are done (and open again when one reopens) (one of manual, items)
  • contractId (string, read-only): Contract of a contract batch (empty otherwise)
  • customerId (string, read-only): The invoice's customer
  • description (string): Description of the milestone
  • dueOn (string (date)): Due date
  • id (string, read-only): Id of the milestone
  • items (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 milestones
  • projectId (string, read-only): Project of a project batch (empty otherwise)
  • scope (string, read-only): (one of project, contract, customer)
  • title (string): Title of the milestone (max length 200)
  • version (integer): Version of the milestone; send it back on change

Example 200 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/string/reopen' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI