List the revisions of a section (tenant:forge:read)
GET /api/forge/v1/projects/{key}/items/{number}/sections/{section}/revisions
Module: Forge · operationId: listForgeSectionRevisions · Tag: Sections · Auth: access token (Authorization: Bearer <accessToken>)
Requires tenant:forge:read and a project the caller sees. Newest first, without content; paged by keyset (follow nextCursor).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
limit |
query | integer | Rows per page (default 200) (default 200; max 500) |
|
cursor |
query | string | 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) |
section |
path | string | yes | Section definition key (e.g. plan) |
Responses
- 200 Revisions (
application/json) - 404 Error (
application/json)
Fields of the 200 answer:
items(array of SectionRevision, required)authorKind(string, required): Kind of actor who wrote itauthorName(string, required): Name of who wrote itauthorRef(string, required): E-mail (or actor ref) of who wrote itcreatedAt(string (date-time), required): When it was writtenversion(integer, required): Version number of the section textbody(string): Only when one revision is read
nextCursor(string): Cursor of the next page (pass it ascursor); missing on the last page.
Example 200 answer:
{
"items": [
{
"authorKind": "person",
"authorName": "Marie Wagner",
"authorRef": "marie.wagner@muster-it.example",
"createdAt": "2026-11-18T09:40:00Z",
"version": 2
},
{
"authorKind": "person",
"authorName": "Marie Wagner",
"authorRef": "marie.wagner@muster-it.example",
"createdAt": "2026-11-04T09:15:00Z",
"version": 1
}
]
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/forge/v1/projects/string/items/1/sections/string/revisions' \
-H "Authorization: Bearer $ACCESS_TOKEN"