---
title: "List page versions, theme versions or the schedule"
method: GET
path: "/projects/{projectId}/versions"
tags: ["Drafts and publishing"]
---

# List page versions, theme versions or the schedule

`GET /projects/{projectId}/versions`

## Request

- Base URL: `https://studio.weaverse.io/api/v1/content`
- URL: `https://studio.weaverse.io/api/v1/content/projects/{projectId}/versions`
- Auth: HTTP bearer

Lists the project's publish history. Which list you get depends on the query:

- `?pageId=<id>`: that page's versions, newest first: history versions and drafts that were published. Unpublished drafts are not listed; read the current draft with `GET /projects/{projectId}/page-drafts/{pageId}`. Takes precedence over `kind`.
- `?kind=theme`: the project's theme versions, newest first.
- `?kind=retired-pages`: history versions whose page assignment no longer exists in this project, for recovery with `restore`. Each row includes `page.name`.
- `?kind=scheduled` (default): the schedule. `data` is an object with `pages` (page versions that are `SCHEDULED`, `PUBLISHED` or `CANCELLED`, with their `page`), `themes` (theme versions in the same states) and `deferredRecaptureCandidates` (`pageId`s of deferred catch-all versions that still need a content recapture through `PUT /versions/{versionId}` with `type: "deferred-page"`).

`limit` defaults to 30 and is capped at 100. It applies to `?pageId=`, `kind=theme` and `kind=retired-pages`; the scheduled list is not limited. Any other `kind` value is 400.

Use a returned version `id` with `/versions/{versionId}` to read, reschedule, replace or cancel it, or with `schedule`, `publish-now` and `restore`.

Required scope: `content:read`

## Response `200`

Version list

- object

## Other responses

- `401`: Missing or invalid credentials
- `403`: Foreign project or missing scope (INSUFFICIENT_SCOPE)
- `404`: Not found (never discloses other tenants)

---

[API](https://skmtc.dev/weaverse/apis/weaverse-content-api.md) - [All operations](https://skmtc.dev/weaverse/apis/weaverse-content-api/llms.txt) - [OpenAPI document](https://skmtc.dev/weaverse/apis/weaverse-content-api/revisions/d189794169bb?raw)