ConnectCloud Developers

History of an item (tenant:forge:read)

GET /api/forge/v1/projects/{key}/items/{number}/events

Module: Forge · operationId: listForgeItemEvents · Tag: Items · Auth: access token (Authorization: Bearer <accessToken>)

Requires tenant:forge:read and a project the caller sees. Oldest first; changes names the fields with from/to (the description is named without its text).

Parameters

Name In Type Required Description
limit query integer 1–500; another value is a 400 invalid. (default 200; max 500)
cursor query string The nextCursor of the previous page.
key path string yes Project key (e.g. APP)
number path integer yes Item number in the project (12 of APP-12)

Responses

  • 200 A page of the history (keyset, nextCursor while more follow) (application/json)
  • 404 Error (application/json)

Fields of the 200 answer:

  • items (array of ItemEvent, required)
    • action (string, required): What happened (one of created, updated, status_changed, assigned, unassigned, labeled, unlabeled, linked, unlinked, commented, comment_edited, comment_deleted, section_updated, moved, closed, reopened, deleted)
    • actorKind (string, required): Kind of actor (person, integration, assistant, automation, system, scm)
    • actorName (string, required): Display name of the actor
    • actorRef (string, required): E-mail (or actor ref) of who made the change
    • changes (object, required): Changed fields with their old (from) and new (to) value
    • createdAt (string (date-time), required): When it happened
    • id (integer, required): Event id (ascending)
    • itemId (string (uuid), required): The item
  • nextCursor (string)

Example 200 answer:

{
  "items": [
    {
      "action": "status_changed",
      "actorKind": "person",
      "actorName": "Marie Wagner",
      "actorRef": "marie.wagner@muster-it.example",
      "changes": {
        "status": {
          "from": "offen",
          "to": "in_arbeit"
        }
      },
      "createdAt": "2026-11-04T09:00:00Z",
      "id": 4807,
      "itemId": "2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c06"
    },
    {
      "action": "status_changed",
      "actorKind": "person",
      "actorName": "Marie Wagner",
      "actorRef": "marie.wagner@muster-it.example",
      "changes": {
        "status": {
          "from": "in_arbeit",
          "to": "review"
        }
      },
      "createdAt": "2026-11-16T16:40:00Z",
      "id": 4812,
      "itemId": "2a3b4c5d-6e7f-4a8b-9c0d-1e2f3a4b5c06"
    }
  ],
  "nextCursor": "eyJpZCI6NDgxMn0"
}

Example request

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

View as Markdown · Interactive reference · OpenAPI