---
title: "Get version history for a workbook"
method: GET
path: "/v2/workbooks/{workbookId}/version-history"
tags: ["Workbooks"]
---

# Get version history for a workbook

`GET /v2/workbooks/{workbookId}/version-history`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/workbooks/{workbookId}/version-history`
- Auth: HTTP bearer

Get version history for a workbook given the workbookId. If the version history contains any tagged versions, the response includes information about the version tag.

## Path parameters

- `workbookId` string, required

## Query parameters

- `page` string
- `limit` number, double

## Response `200`

The response body.

- WorkbooksGetVersionHistoryResponse200
  - `entries` V2WorkbooksWorkbookIdVersionHistoryGetResponsesContentApplicationJsonSchemaEntriesItems[], required
    - `version` number, double, required
    - `publishedAt` string, date-time, required
    - `publishedBy` string, required
    - `tags` V2WorkbooksWorkbookIdVersionHistoryGetResponsesContentApplicationJsonSchemaEntriesItemsTagsItems[]
      - `versionTagId` string, required
      - `taggedAt` string, date-time, required
      - `taggedBy` string, required
  - `nextPage` string, nullable, required
  - `total` number, double

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)
