## Files of the ticket: every file, mail attachments, inline images, originals (.eml) and generated files (desk:read)

`GET /api/desk/v1/items/{ref}/attachments`

Module: Desk · operationId: `listItemAttachments` · Tag: Mail · Auth: access token (`Authorization: Bearer <accessToken>`)

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `ref` | path | string | yes | Item id or number |

### Responses

- **200** Files (`application/json`)

Fields of the 200 answer:

- `items` (array of ItemAttachment, required)
  - `contentId` (string): Content-ID of an inline image
  - `createdAt` (string (date-time)): When the file was added
  - `documentId` (string): DMS document holding the file
  - `entryId` (string): Entry (mail or comment) the file came with
  - `id` (string): Id of the file record
  - `inline` (boolean): An inline image of a mail body
  - `itemId` (string): Item the file belongs to
  - `mime` (string): MIME type
  - `name` (string): File name
  - `portalVisible` (boolean): Requesters see the file in the customer portal
  - `size` (integer): Size in bytes
  - `source` (string): mail: attachment of a mail; upload: staff upload; portal: requester upload; conversion: brought along by a conversion; eml: the original (.eml) of a received or sent mail (entryId set, never visible to requesters, never handed to forge); generated: made by desk (meeting transcripts) (one of `mail`, `upload`, `portal`, `conversion`, `eml`, `generated`)
  - `uploadedBy` (string): Login (e-mail) of who uploaded it

Example 200 answer:

```json
{
  "items": [
    {
      "createdAt": "2026-11-17T08:41:00Z",
      "documentId": "3d0e1f2a-4b5c-4d6e-9f8a-0b1c2d3e4f01",
      "id": "2c9d0e1f-3a4b-4c5d-8e7f-9a0b1c2d3e01",
      "inline": false,
      "itemId": "4a1b2c3d-5e6f-4a7b-8c9d-1e2f3a4b5c01",
      "mime": "text/plain",
      "name": "Controller-Log_AP-207.txt",
      "portalVisible": false,
      "size": 18233,
      "source": "upload",
      "uploadedBy": "lukas.wimmer@muster-it.example"
    }
  ]
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/desk/v1/items/string/attachments' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
