ConnectCloud Developers

Run a saved view (tenant:forge:read)

GET /api/forge/v1/views/{id}/items

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

Requires tenant:forge:read and a view the caller may see (else 404). Runs the view's query and sort through the same search as GET /items (a project view or a personal view of a project through GET /projects/{key}/items, so its default sort is rank; a tenant-wide view through GET /items, default sort updated) and answers the same page; cursor and limit continue it. assignee me means the caller.

Parameters

Name In Type Required Description
cursor query string nextCursor of the previous page
limit query integer (default 50; max 200)
id path string (uuid) yes

Responses

  • 200 Items (application/json)
  • 400 Error (application/json)
  • 404 Error (application/json)

Fields of the 200 answer:

  • items (array of Item, required): One page of items
    • assignees (array of string, required): E-mail addresses of the assignees
    • createdAt (string (date-time), required): When the item was created
    • customFields (object, required): Values of custom fields by field key
    • description (string, required): Markdown
    • id (string (uuid), required): Item id
    • labelIds (array of string (uuid), required): Label ids
    • labels (array of string, required): Label names
    • number (integer, required): Number in the project (the 12 of APP-12)
    • projectId (string (uuid), required): Project id
    • projectKey (string, required): Project key
    • rank (string, required): Order key, compared byte-wise
    • ref (string, required): APP-12
    • reporterRef (string, required): E-mail (or actor ref) of who created the item
    • statusCategory (string, required): Category of the status (one of triage, todo, active, on_hold, done, cancelled)
    • statusId (string (uuid), required): Status id
    • statusKey (string, required): Status key
    • statusName (string, required): Status name
    • title (string, required): Title
    • typeId (string (uuid), required): Item type id
    • typeKey (string, required): Item type key
    • updatedAt (string (date-time), required): Last change
    • version (integer, required): Optimistic-locking version; send it with PATCH
    • watchers (array of string, required): E-mail addresses of the watchers
    • closedAt (string (date-time), nullable): When the item reached a done or cancelled status; null while open
    • confidential (boolean): Visible only to tenant forge admins, members with role maintainer or higher, the reporter and the assignees
    • convertedTo (object): Set on the tombstone of an item converted to another module (read-only)
      • at (string (date-time), required): When it was converted
      • id (string (uuid), required): Id of the new item
      • module (string, required): Module of the new item (one of desk, forge)
      • path (string, required): Portal path of the new item
      • ref (string, required): #123 or APP-12
    • convertingSince (string (date-time)): Set while a conversion of the item is pending
    • dueOn (string (date), nullable): Due date
    • estimate (number, nullable): Estimate; null when none
    • iterationId (string (uuid), nullable): Iteration the item is in; null when none
    • iterationName (string, nullable): Name of the iteration
    • milestoneId (string (uuid), nullable): Milestone the item is in; null when none
    • milestoneTitle (string, nullable): Title of the milestone
    • parentId (string (uuid), nullable): Parent item id; null without a parent
    • parentNumber (integer, nullable): Number of the parent item; null without a parent
    • resolution (string, nullable): returned: handed back to its origin; converted: the tombstone of a converted item (one of done, not_planned, duplicate, returned, converted, <nil>)
    • spentMinutes (integer, nullable, read-only): Work HR booked on the item (subject forge:item:<id>, worked minus breaks, ADR 0040); filled by the item read and the item lists, null when HR does not answer (never an error) and in answers of writes
    • startOn (string (date), nullable): Planned start date
  • nextCursor (string, nullable, required): Cursor of the next page; null at the end

Example 200 answer:

{
  "items": [
    {
      "assignees": [
        "paul.schmid@muster-it.example"
      ],
      "closedAt": null,
      "confidential": false,
      "createdAt": "2026-11-09T11:20:00Z",
      "customFields": {
        "story_points": 3
      },
      "description": "Bei einer Antwort des Service Desks erscheint die Benachrichtigung auf Android zweimal.",
      "estimate": 3,
      "id": "2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c09",
      "iterationId": "f1b2c3d4-e5f6-4a7b-9c34-1f2a3b4c5d02",
      "iterationName": "Iteration 2 – Ticketübersicht",
      "labelIds": [
        "8a4b5c6d-7e8f-4a9b-8cad-4e5f6a7b8c04",
        "8a4b5c6d-7e8f-4a9b-8cad-4e5f6a7b8c06",
        "8a4b5c6d-7e8f-4a9b-8cad-4e5f6a7b8c05",
        "8a4b5c6d-7e8f-4a9b-8cad-4e5f6a7b8c03"
      ],
      "labels": [
        "bug",
        "owner::android",
        "plattform::android",
        "priority::hoch"
      ],
      "milestoneId": "e0a1b2c3-d4e5-4f6a-8b23-0e1f2a3b4c02",
      "milestoneTitle": "Version 1.1 – Ticketübersicht",
      "number": 9,
      "parentId": null,
      "parentNumber": null,
      "projectId": "0b6c1e1e-3f0b-4e8e-9f3f-1d2c3b4a5f60",
      "projectKey": "APP",
      "rank": "0000a2",
      "ref": "APP-9",
      "reporterRef": "ben.koch@muster-it.example",
      "resolution": null,
      "spentMinutes": 420,
      "statusCategory": "active",
      "statusId": "5d1e2f3a-4b5c-4d6e-8f7a-1b2c3d4e5f03",
      "statusKey": "in_arbeit",
      "statusName": "In Arbeit",
      "title": "Push-Benachrichtigung erscheint doppelt",
      "typeId": "7f3a4b5c-6d7e-4f8a-9b9c-3d4e5f6a7b04",
      "typeKey": "fehler",
      "updatedAt": "2026-11-13T10:00:00Z",
      "version": 5,
      "watchers": [
        "ben.koch@muster-it.example",
        "emma.maier@muster-it.example",
        "paul.schmid@muster-it.example"
      ]
    },
    {
      "assignees": [
        "marie.wagner@muster-it.example"
      ],
      "closedAt": null,
      "confidential": false,
      "createdAt": "2026-10-28T10:30:00Z",
      "customFields": {
        "story_points": 3
      },
      "description": "Wiederverwendbare Filterleiste mit Status-Auswahl und Zeitraum, auf dem Smartphone als Bottom-Sheet.",
      "estimate": 3,
      "id": "2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c06",
      "iterationId": "f1b2c3d4-e5f6-4a7b-9c34-1f2a3b4c5d02",
      "iterationName": "Iteration 2 – Ticketübersicht",
      "labelIds": [
        "8a4b5c6d-7e8f-4a9b-8cad-4e5f6a7b8c01",
        "8a4b5c6d-7e8f-4a9b-8cad-4e5f6a7b8c02"
      ],
      "labels": [
        "bereich::frontend",
        "priority::mittel"
      ],
      "milestoneId": "e0a1b2c3-d4e5-4f6a-8b23-0e1f2a3b4c02",
      "milestoneTitle": "Version 1.1 – Ticketübersicht",
      "number": 6,
      "parentId": "2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c05",
      "parentNumber": 5,
      "projectId": "0b6c1e1e-3f0b-4e8e-9f3f-1d2c3b4a5f60",
      "projectKey": "APP",
      "rank": "0000a8",
      "ref": "APP-6",
      "reporterRef": "emma.maier@muster-it.example",
      "resolution": null,
      "spentMinutes": 960,
      "statusCategory": "active",
      "statusId": "5d1e2f3a-4b5c-4d6e-8f7a-1b2c3d4e5f04",
      "statusKey": "review",
      "statusName": "Review",
      "title": "Filterleiste als Komponente",
      "typeId": "7f3a4b5c-6d7e-4f8a-9b9c-3d4e5f6a7b03",
      "typeKey": "aufgabe",
      "updatedAt": "2026-11-16T16:40:00Z",
      "version": 4,
      "watchers": [
        "emma.maier@muster-it.example",
        "marie.wagner@muster-it.example"
      ]
    }
  ],
  "nextCursor": "eyJzb3J0IjoidXBkYXRlZCIsInZhbHVlIjoiMjAyNi0xMS0xNlQxNjo0MDowMFoifQ"
}

Example request

curl -X GET 'https://api.mbcom.cloud/api/forge/v1/views/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/items' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI