## Mark a milestone reached; writes desk.project.milestone_achieved (desk:write)

`POST /api/desk/v1/projects/{id}/milestones/{mid}/achieve`

Module: Desk · operationId: `achieveProjectMilestone` · 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: already 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:

```json
{
  "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

```bash
curl -X POST 'https://api.mbcom.cloud/api/desk/v1/projects/string/milestones/string/achieve' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
