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 changeactorRef(string): Login (e-mail) of who made the changechanges(array of object): Changed fieldsfield(string): Changed fieldfrom(any): Value beforeto(any): Value after
createdAt(string (date-time)): When the change happenedid(string): Id of the history entryitemId(string): Item the change belongs toreason(string): Why the change was made
nextCursor(string): Cursor of the next page (pass it ascursor); 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"