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,
nextCursorwhile more follow) (application/json) - 404 Error (
application/json)
Fields of the 200 answer:
items(array of ItemEvent, required)action(string, required): What happened (one ofcreated,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 actoractorRef(string, required): E-mail (or actor ref) of who made the changechanges(object, required): Changed fields with their old (from) and new (to) valuecreatedAt(string (date-time), required): When it happenedid(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"