ConnectCloud Developers

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

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

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

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

Parameters

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

Responses

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

Fields of the 200 answer:

  • items (array of IterationView, required)

Example 200 answer:

{
  "items": [
    {
      "closedAt": "2026-11-04T08:30:00Z",
      "createdAt": "2026-10-07T10:00:00Z",
      "endsOn": "2026-11-03",
      "goal": "Anmeldung mit Passkey auf iOS und Android, Fehlermeldungen verständlich.",
      "id": "f1b2c3d4-e5f6-4a7b-9c34-1f2a3b4c5d01",
      "name": "Iteration 1 – Anmeldung",
      "position": 0,
      "progress": {
        "byCategory": {
          "active": 0,
          "cancelled": 1,
          "done": 5,
          "on_hold": 0,
          "todo": 1,
          "triage": 0
        },
        "committed": 21,
        "estimate": {
          "done": 18,
          "total": 22
        },
        "total": 7
      },
      "startedAt": "2026-10-14T09:30:00Z",
      "startsOn": "2026-10-14",
      "state": "closed",
      "updatedAt": "2026-11-04T08:30:00Z",
      "version": 4
    },
    {
      "closedAt": null,
      "createdAt": "2026-10-28T11:00:00Z",
      "endsOn": "2026-11-24",
      "goal": "Kunden sehen ihre Tickets mit Filtern und laden lange Listen nach.",
      "id": "f1b2c3d4-e5f6-4a7b-9c34-1f2a3b4c5d02",
      "name": "Iteration 2 – Ticketübersicht",
      "position": 1,
      "progress": {
        "byCategory": {
          "active": 2,
          "cancelled": 0,
          "done": 4,
          "on_hold": 0,
          "todo": 1,
          "triage": 0
        },
        "committed": 16,
        "estimate": {
          "done": 9,
          "total": 19
        },
        "total": 7
      },
      "startedAt": "2026-11-04T09:30:00Z",
      "startsOn": "2026-11-04",
      "state": "active",
      "updatedAt": "2026-11-04T09:30:00Z",
      "version": 3
    }
  ]
}

Example request

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

View as Markdown · Interactive reference · OpenAPI