Drafts and publishing

List page versions, theme versions or the schedule

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 (pageIds 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

get/projects/{projectId}/versions

Request

  • Base URL
    https://studio.weaverse.io/api/v1/content
  • Auth
    HTTP bearer

Response

Version list

object required

Changes

No recorded changes to this operation across all 1 revision of this API.