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 addedid(string (uuid), required): Attachment iditemId(string (uuid), required): The item the file belongs tomime(string, required): MIME typename(string, required): File namesize(integer, required): Size in bytessource(string, required):upload: uploaded to the item;conversion: taken over by a conversion (one ofupload,conversion)uploadedByRef(string, required): E-mail of who uploaded itcommentId(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"