## AI suggestions of an item, newest first (desk:read)

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

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

### Parameters

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

### Responses

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

Fields of the 200 answer:

- `items` (array of Suggestion, required)
  - `appliedChanges` (array of object): Changes the suggestion made to the item
  - `confidence` (number, nullable): Lowest confidence of the decisions; null when the suggestion holds none (e.g. only text read from the ticket)
  - `createdAt` (string (date-time)): When it was made
  - `decidedAt` (string (date-time)): When it was decided
  - `decidedBy` (string): Login (e-mail) of who decided
  - `editedPayload` (object): What the person accepted when it differs from the proposal
  - `feature` (string): AI feature that made it (one of `triage`, `subject`, `summary`, `draftReply`)
  - `feedbackNote` (string): Note with the rating
  - `feedbackRating` (integer): Rating of the suggestion
  - `id` (string): Id of the suggestion
  - `itemId` (string): Item the suggestion is for
  - `method` (string): How the ai module answered (e.g. chat)
  - `model` (string): Model that answered
  - `payload` (object): triage: TriagePayload; others: { text }
  - `reason` (string): Why the model proposes it
  - `status` (string): State of the suggestion (one of `pending`, `accepted`, `rejected`, `auto_applied`, `superseded`, `undone`)

Example 200 answer:

```json
{
  "items": [
    {
      "confidence": 0.88,
      "createdAt": "2026-11-17T07:12:20Z",
      "decidedAt": "2026-11-17T07:15:00Z",
      "decidedBy": "sophie.huber@muster-it.example",
      "feature": "triage",
      "id": "6a3b4c5d-7e8f-4a9b-8c1d-3e4f5a6b7c02",
      "itemId": "4a1b2c3d-5e6f-4a7b-8c9d-1e2f3a4b5c01",
      "method": "decision",
      "model": "decision",
      "payload": {
        "category": {
          "confidence": 0.93,
          "label": "Netzwerk › WLAN",
          "value": "0c7d8e9f-1a2b-4c3d-8e5f-7a8b9c0d1e02"
        },
        "priority": {
          "confidence": 0.91,
          "label": "Hoch",
          "value": "hoch"
        },
        "team": {
          "confidence": 0.88,
          "label": "Technik",
          "value": "second-level"
        }
      },
      "status": "accepted"
    }
  ]
}
```

### Example request

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