ConnectCloud Developers

List the milestones of a project (tenant:forge:read)

GET /api/forge/v1/projects/{key}/milestones

Module: Forge · operationId: listForgeMilestones · Tag: Milestones · Auth: access token (Authorization: Bearer <accessToken>)

Requires tenant:forge:read and a project the caller sees. Each milestone carries its progress.

Parameters

Name In Type Required Description
state query string (one of open, closed)
key path string yes Project key (e.g. APP)

Responses

  • 200 The milestones (application/json)
  • 400 Error (application/json)
  • 404 Error (application/json)

Fields of the 200 answer:

  • items (array of MilestoneView, required)

Example 200 answer:

{
  "items": [
    {
      "closedAt": "2026-11-04T10:00:00Z",
      "createdAt": "2026-09-23T10:00:00Z",
      "description": "Erste Version im App Store und bei Google Play mit Anmeldung per Passkey.",
      "dueOn": "2026-11-04",
      "id": "e0a1b2c3-d4e5-4f6a-8b23-0e1f2a3b4c01",
      "position": 0,
      "progress": {
        "byCategory": {
          "active": 0,
          "cancelled": 1,
          "done": 8,
          "on_hold": 0,
          "todo": 0,
          "triage": 0
        },
        "estimate": {
          "done": 28,
          "total": 28
        },
        "total": 9
      },
      "releaseProvider": "github",
      "releaseRepo": "mbcomdev/demo-app",
      "releaseTag": "v1.0.0",
      "state": "closed",
      "title": "Version 1.0 – Anmeldung",
      "updatedAt": "2026-11-04T10:00:00Z",
      "version": 3
    },
    {
      "closedAt": null,
      "createdAt": "2026-09-30T13:00:00Z",
      "description": "Kunden sehen ihre Tickets mit Filtern, Seitenwechseln und einem verständlichen leeren Zustand.",
      "dueOn": "2026-11-25",
      "id": "e0a1b2c3-d4e5-4f6a-8b23-0e1f2a3b4c02",
      "position": 1,
      "progress": {
        "byCategory": {
          "active": 2,
          "cancelled": 0,
          "done": 5,
          "on_hold": 0,
          "todo": 2,
          "triage": 0
        },
        "estimate": {
          "done": 12,
          "total": 25
        },
        "total": 9
      },
      "releaseProvider": "github",
      "releaseRepo": null,
      "releaseTag": null,
      "state": "open",
      "title": "Version 1.1 – Ticketübersicht",
      "updatedAt": "2026-10-21T10:15:00Z",
      "version": 2
    }
  ]
}

Example request

curl -X GET 'https://api.mbcom.cloud/api/forge/v1/projects/string/milestones' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI