Revisions

Revisions in GitBook are the entity for updates made to content.

GET a specific revision in a space by it's ID

Get a specific revision in a space

GEThttps://api.gitbook.com/v1/spaces/{spaceId}/revisions/{revisionId}

Authorization

user

Path parameters

spaceId*string

The unique id of the space

revisionId*string

The unique id of the revision

Query parameters

Response

200default

OK

Body

application/json

Revision (one of)

RevisionTypeEdits (all of)RevisionTypeMerge (all of)RevisionTypeRollback (all of)RevisionTypeUpdate (all of)RevisionTypeComputed (all of)

Request

JavaScriptCurlPython

const response = await fetch('https://api.gitbook.com/v1/spaces/{spaceId}/revisions/{revisionId}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

200default

{
  "object": "revision",
  "id": "text",
  "parents": [
    "text"
  ],
  "pages": [
    {
      "id": "text",
      "title": "text",
      "emoji": "🎉",
      "icon": "gear",
      "createdAt": "2025-01-15T11:45:35.491Z",
      "updatedAt": "2025-01-15T11:45:35.491Z",
      "markdown": "text",
      "type": "document",
      "urls": {
        "app": "https://example.com"
      },
      "slug": "text",
      "path": "text",
      "description": "text",
      "documentId": "text",
      "pages": [],
      "git": {
        "oid": "text",
        "path": "text"
      },
      "layout": {
        "cover": false,
        "coverSize": "hero",
        "title": false,
        "description": false,
        "tableOfContents": false,
        "outline": false,
        "pagination": false
      },
      "cover": {
        "ref": {
          "kind": "file",
          "file": "text"
        },
        "yPos": 0
      },
      "hidden": false,
      "noIndex": false,
      "noRobotsIndex": false,
      "computed": {
        "integration": "text",
        "source": "text",
        "props": {},
        "dependsOn": [
          {
            "kind": "space",
            "space": "text"
          }
        ]
      }
    }
  ],
  "files": [
    {
      "id": "text",
      "name": "text",
      "contentType": "text",
      "downloadURL": "text",
      "size": 0,
      "dimensions": {
        "width": 0,
        "height": 0
      },
      "git": {
        "oid": "text",
        "path": "text"
      }
    }
  ],
  "reusableContents": [
    {
      "id": "text",
      "title": "text",
      "document": "text",
      "git": {
        "oid": "text",
        "path": "text"
      }
    }
  ],
  "createdAt": "2025-01-15T11:45:35.491Z",
  "git": {
    "oid": "text",
    "message": "text",
    "createdByGitBook": false,
    "url": "text",
    "ref": "text"
  },
  "urls": {
    "app": "https://example.com",
    "published": "https://example.com",
    "public": "https://example.com"
  },
  "type": "edits"
}

GET a specific page in a revision by it's ID

Get a page by its ID in a revision.

GEThttps://api.gitbook.com/v1/spaces/{spaceId}/revisions/{revisionId}/page/{pageId}

Authorization

user

Path parameters

spaceId*string

The unique id of the space

revisionId*string

The unique id of the revision

pageId*string

The unique id of the page

Query parameters

Response

200default

OK

Body

application/json

RevisionPage (one of)

RevisionPageDocument (all of)RevisionPageGroup (all of)RevisionPageLink (all of)RevisionPageComputed (all of)

Request

JavaScriptCurlPython

const response = await fetch('https://api.gitbook.com/v1/spaces/{spaceId}/revisions/{revisionId}/page/{pageId}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

200default

{
  "id": "text",
  "title": "text",
  "emoji": "🎉",
  "icon": "gear",
  "createdAt": "2025-01-15T11:45:35.491Z",
  "updatedAt": "2025-01-15T11:45:35.491Z",
  "markdown": "text",
  "type": "document",
  "urls": {
    "app": "https://example.com"
  },
  "slug": "text",
  "path": "text",
  "description": "text",
  "documentId": "text",
  "pages": [],
  "git": {
    "oid": "text",
    "path": "text"
  },
  "layout": {
    "cover": false,
    "coverSize": "hero",
    "title": false,
    "description": false,
    "tableOfContents": false,
    "outline": false,
    "pagination": false
  },
  "cover": {
    "ref": {
      "kind": "file",
      "file": "text"
    },
    "yPos": 0
  },
  "hidden": false,
  "noIndex": false,
  "noRobotsIndex": false,
  "computed": {
    "integration": "text",
    "source": "text",
    "props": {},
    "dependsOn": [
      {
        "kind": "space",
        "space": "text"
      }
    ]
  }
}

GET a specific revision in a space by it's path

Get a page by its path in a revision.

GEThttps://api.gitbook.com/v1/spaces/{spaceId}/revisions/{revisionId}/path/{pagePath}

Authorization

user

Path parameters

spaceId*string

The unique id of the space

revisionId*string

The unique id of the revision

pagePath*string

The path of the page in the revision.

Query parameters

Response

200default

OK

Body

application/json

one of

RevisionPageDocument (all of)RevisionPageGroup (all of)

Request

JavaScriptCurlPython

const response = await fetch('https://api.gitbook.com/v1/spaces/{spaceId}/revisions/{revisionId}/path/{pagePath}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

200default

{
  "id": "text",
  "title": "text",
  "emoji": "🎉",
  "icon": "gear",
  "createdAt": "2025-01-15T11:45:35.491Z",
  "updatedAt": "2025-01-15T11:45:35.491Z",
  "markdown": "text",
  "type": "document",
  "urls": {
    "app": "https://example.com"
  },
  "slug": "text",
  "path": "text",
  "description": "text",
  "documentId": "text",
  "pages": [],
  "git": {
    "oid": "text",
    "path": "text"
  },
  "layout": {
    "cover": false,
    "coverSize": "hero",
    "title": false,
    "description": false,
    "tableOfContents": false,
    "outline": false,
    "pagination": false
  },
  "cover": {
    "ref": {
      "kind": "file",
      "file": "text"
    },
    "yPos": 0
  },
  "hidden": false,
  "noIndex": false,
  "noRobotsIndex": false,
  "computed": {
    "integration": "text",
    "source": "text",
    "props": {},
    "dependsOn": [
      {
        "kind": "space",
        "space": "text"
      }
    ]
  }
}

GET files in a specific revision by it's ID

List all files in a revision

GEThttps://api.gitbook.com/v1/spaces/{spaceId}/revisions/{revisionId}/files

Authorization

user

Path parameters

spaceId*string

The unique id of the space

revisionId*string

The unique id of the revision

Query parameters

Response

200default

OK

Body

application/json

nextobject

countnumber

Total count of objects in the list

items*array of RevisionFile (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.gitbook.com/v1/spaces/{spaceId}/revisions/{revisionId}/files', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

200default

{
  "next": {
    "page": "text"
  },
  "count": 0,
  "items": [
    {
      "id": "text",
      "name": "text",
      "contentType": "text",
      "downloadURL": "text",
      "size": 0,
      "dimensions": {
        "width": 0,
        "height": 0
      },
      "git": {
        "oid": "text",
        "path": "text"
      }
    }
  ]
}