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)

Request

JavaScriptCurl

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

{
  "object": "revision",
  "id": "text",
  "parents": [
    "text"
  ],
  "pages": [
    {
      "id": "text",
      "title": "text",
      "emoji": "🎉",
      "createdAt": "2024-04-18T10:28:21.593Z",
      "updatedAt": "2024-04-18T10:28:21.593Z",
      "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
      }
    }
  ],
  "files": [
    {
      "id": "text",
      "name": "text",
      "contentType": "text",
      "downloadURL": "text",
      "size": 0,
      "dimensions": {
        "width": 0,
        "height": 0
      },
      "git": {
        "oid": "text",
        "path": "text"
      }
    }
  ],
  "createdAt": "2024-04-18T10:28:21.593Z",
  "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)

Request

JavaScriptCurl

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

{
  "id": "text",
  "title": "text",
  "emoji": "🎉",
  "createdAt": "2024-04-18T10:28:21.593Z",
  "updatedAt": "2024-04-18T10:28:21.593Z",
  "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
  }
}

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

JavaScriptCurl

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

{
  "id": "text",
  "title": "text",
  "emoji": "🎉",
  "createdAt": "2024-04-18T10:28:21.593Z",
  "updatedAt": "2024-04-18T10:28:21.593Z",
  "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
  }
}

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

JavaScriptCurl

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

{
  "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"
      }
    }
  ]
}