ConnectCloud Developers

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 of created, 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 of workflow, 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"

View as Markdown · Interactive reference · OpenAPI