Latest changes of a workflow, SLA policy or space, with the notes sent with them (desk:admin; a space also its maintainers)
GET /api/desk/v1/config-changes
Module: Desk · operationId: listConfigChanges · Tag: Configuration · Auth: access token (Authorization: Bearer <accessToken>)
Every save of a workflow, an SLA policy or a space is recorded with who saved it, when and the optional note
of the save request (ChangeNote). Newest first. Workflows and SLA policies need desk:admin; a space also
its maintainers (403 for other members, 404 for a space the caller does not see).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
kind |
query | string | yes | (one of workflow, sla_policy, space) |
objectId |
query | string (uuid) | yes | The workflow, policy or space |
limit |
query | integer | (default 5; max 50) |
Responses
- 200 Changes (
application/json) - 400 Error (
application/json) - 403 Error (
application/json) - 404 Error (
application/json)
Fields of the 200 answer:
items(array of ConfigChange, required)action(string, required): (one ofcreated,updated)actorName(string, required): Their name in histories; the platform team acting in a customer tenant reads „Plattformbetrieb (MBCOM) · “actorRef(string, required): Who saved it (e-mail or login)at(string (date-time), required)id(string (uuid), required)kind(string, required): (one ofworkflow,sla_policy,space)note(string, required): The note sent with the save (empty = none)objectId(string (uuid), required): The workflow, policy or space
Example 200 answer:
{
"items": [
{
"action": "updated",
"actorName": "Marie Wagner",
"actorRef": "marie.wagner@muster-it.example",
"at": "2026-11-10T09:12:00Z",
"id": "0e7f8a9b-1c2d-4e3f-8a5b-7c8d9e0f1a01",
"kind": "workflow",
"note": "Status „Wartet auf Dritte“ pausiert jetzt die SLA-Uhr",
"objectId": "4c1d2e3f-5a6b-4c7d-8e9f-1a2b3c4d5e01"
},
{
"action": "created",
"actorName": "Elias Gruber",
"actorRef": "elias.gruber@muster-it.example",
"at": "2026-09-01T07:00:00Z",
"id": "0e7f8a9b-1c2d-4e3f-8a5b-7c8d9e0f1a02",
"kind": "workflow",
"note": "",
"objectId": "4c1d2e3f-5a6b-4c7d-8e9f-1a2b3c4d5e01"
}
]
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/desk/v1/config-changes?kind=workflow&objectId=3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12' \
-H "Authorization: Bearer $ACCESS_TOKEN"