List all pages in a specific historical revision of a space
Returns the full hierarchy of all pages (document pages and group pages) in a specific historical revision of a space. Use this to inspect the complete page tree of a past snapshot. For the current live content pages, use the space content pages endpoint. With tag, the hierarchy is narrowed to the document pages with any of those tags, plus the pages above them.
A unique entity identifier
^[a-zA-Z0-9_-]+$A unique entity identifier
^[a-zA-Z0-9_-]+$If false is passed, "git" mutable metadata will not returned. Passing false can optimize performances of the lookup.
trueIf false is passed, content will not be computed
trueNarrow the page hierarchy to the document pages tagged with any of these tag or category slugs (OR), plus the pages above them. Repeat the parameter for several slugs. A tag or category also matches pages tagged with anything nested below it; categories never match through direct page assignments. Hidden pages are left out when filtering, and unknown slugs match nothing.
OK
GET /v1/spaces/{spaceId}/revisions/{revisionId}/pages HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
OK
{
"pages": [
{
"id": "text",
"title": "text",
"linkTitle": "text",
"emoji": "🎉",
"icon": "gear",
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z",
"condition": "text",
"markdown": "# Hello World\n\nThis is a markdown document linking to [another page](/pages/page_id).\n",
"type": "document",
"urls": {
"app": "https://example.com"
},
"slug": "text",
"path": "text",
"description": "text",
"tagTitle": "text",
"pages": [
"[Circular Reference]"
],
"git": {
"oid": "text",
"path": "text"
},
"layout": {
"width": "default",
"cover": true,
"coverSize": "hero",
"coverMask": "none",
"title": true,
"description": true,
"tableOfContents": true,
"outline": true,
"pagination": true,
"metadata": true,
"tags": true,
"actions": true,
"anchors": true
},
"cover": {
"ref": {
"kind": "file",
"file": "text",
"space": "text"
},
"refDark": {
"kind": "file",
"file": "text",
"space": "text"
},
"textColor": "black",
"textColorDark": "black",
"yPos": 0,
"height": 240
},
"variables": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"hidden": false,
"noIndex": false,
"noRobotsIndex": false,
"metaLinks": {
"canonical": {
"kind": "page",
"page": "text",
"space": "text"
},
"alternates": [
{
"kind": "page",
"page": "text",
"space": "text"
}
]
},
"tags": [
{
"tag": {
"kind": "tag",
"tag": "text",
"space": "text"
},
"primary": true
}
],
"computed": {
"type": "builtin:openapi",
"dependencies": {
"spec": {
"ref": {
"kind": "openapi",
"spec": "text"
}
}
},
"props": {
"doc": "models"
}
},
"computedSeed": "text"
}
]
}Last updated
Was this helpful?