ConnectCloud Developers

List the files of an item (tenant:forge:read)

GET /api/forge/v1/projects/{key}/items/{number}/attachments

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

Requires tenant:forge:read and an item the caller sees. Oldest first; source upload or conversion (a file of the source item, the same DMS document).

Parameters

Name In Type Required Description
key path string yes Project key (e.g. APP)
number path integer yes Item number in the project (12 of APP-12)

Responses

  • 200 Files (application/json)
  • 404 Error (application/json)

Fields of the 200 answer:

  • items (array of Attachment, required)
    • createdAt (string (date-time), required): When the file was added
    • id (string (uuid), required): Attachment id
    • itemId (string (uuid), required): The item the file belongs to
    • mime (string, required): MIME type
    • name (string, required): File name
    • size (integer, required): Size in bytes
    • source (string, required): upload: uploaded to the item; conversion: taken over by a conversion (one of upload, conversion)
    • uploadedByRef (string, required): E-mail of who uploaded it
    • commentId (string (uuid), nullable): The comment the file came with (conversions)

Example 200 answer:

{
  "items": [
    {
      "commentId": null,
      "createdAt": "2026-11-06T08:45:00Z",
      "id": "5b6c7d8e-9f0a-4b1c-8d2e-4f5a6b7c8d01",
      "itemId": "2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c11",
      "mime": "application/pdf",
      "name": "Absturzbericht_iOS_17.pdf",
      "size": 48213,
      "source": "upload",
      "uploadedByRef": "ben.koch@muster-it.example"
    },
    {
      "commentId": null,
      "createdAt": "2026-11-06T08:44:00Z",
      "id": "5b6c7d8e-9f0a-4b1c-8d2e-4f5a6b7c8d02",
      "itemId": "2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c11",
      "mime": "image/png",
      "name": "Absturz_PDF_Anhang_iOS.png",
      "size": 182334,
      "source": "upload",
      "uploadedByRef": "ben.koch@muster-it.example"
    }
  ]
}

Example request

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

View as Markdown · Interactive reference · OpenAPI