ConnectCloud Developers

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:

{
  "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

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

View as Markdown · Interactive reference · OpenAPI