ConnectCloud Developers

Complete change history (desk:read)

GET /api/desk/v1/items/{ref}/events

Module: Desk · operationId: listItemEvents · Tag: Activity · Auth: access token (Authorization: Bearer <accessToken>)

Parameters

Name In Type Required Description
limit query integer Rows per page (default 200) (default 200; max 500)
cursor query string The nextCursor of the previous page (keyset, bound to the list and its order); anything else is 400 invalid with field: cursor.
ref path string yes Item id or number

Responses

  • 200 Events (application/json)

Fields of the 200 answer:

  • items (array of Event, required)
    • action (string): What happened (created, updated, transitioned, …)
    • actorName (string): Name of who made the change
    • actorRef (string): Login (e-mail) of who made the change
    • changes (array of object): Changed fields
      • field (string): Changed field
      • from (any): Value before
      • to (any): Value after
    • createdAt (string (date-time)): When the change happened
    • id (string): Id of the history entry
    • itemId (string): Item the change belongs to
    • reason (string): Why the change was made
  • nextCursor (string): Cursor of the next page (pass it as cursor); missing on the last page.

Example 200 answer:

{
  "items": [
    {
      "action": "transitioned",
      "actorName": "Sophie Huber",
      "actorRef": "sophie.huber@muster-it.example",
      "changes": [
        {
          "field": "status",
          "from": "neu",
          "to": "in_bearbeitung"
        }
      ],
      "createdAt": "2026-11-17T07:21:00Z",
      "id": "7c4d5e6f-8a9b-4c0d-9e1f-2a3b4c5d6e01",
      "itemId": "4a1b2c3d-5e6f-4a7b-8c9d-1e2f3a4b5c01",
      "reason": ""
    },
    {
      "action": "updated",
      "actorName": "Lukas Wimmer",
      "actorRef": "lukas.wimmer@muster-it.example",
      "changes": [
        {
          "field": "labelIds",
          "from": [
            "9b6c7d8e-0f1a-4b2c-9d4e-6f7a8b9c0d02"
          ],
          "to": [
            "9b6c7d8e-0f1a-4b2c-9d4e-6f7a8b9c0d02",
            "9b6c7d8e-0f1a-4b2c-9d4e-6f7a8b9c0d01"
          ]
        }
      ],
      "createdAt": "2026-11-17T08:46:00Z",
      "id": "7c4d5e6f-8a9b-4c0d-9e1f-2a3b4c5d6e02",
      "itemId": "4a1b2c3d-5e6f-4a7b-8c9d-1e2f3a4b5c01",
      "reason": ""
    }
  ],
  "nextCursor": "eyJpZCI6IjdjNGQ1ZTZmIn0"
}

Example request

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

View as Markdown · Interactive reference · OpenAPI