---
title: "Service: /members/{member}/groups/{group}/publications/{publicationid}/versions [POST]"
source: https://dev.pageseeder.com/api/services/create-publication-version-POST.html
description: "Creates versions of all documents in a publication by adding version references to xref target URIs. Supports recursive processing for embedded/transcluded content. Runs asynchronously and requires approver permissions."
last_updated: 2026-09-02T11:36:14+10:00
document_type: api_endpoint
operation_id: version-POST
resource_id: version
path_template: /members/{member}/groups/{group}/publications/{publicationid}/versions
http_method: POST
api_category: version
implementation_version: 6.2005
api_since: 5.9802
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: N/A
generated_at: 2026-09-02
tokens: ~358
---

# /members/\{member\}/groups/\{group\}/publications/\{publicationid\}/versions \[POST\]

## Description

Versions all documents in a publication.

Starting at [publication](../../reference/glossary/publications.md) root URI, adds [versions](../../reference/glossary/version.md) to all xref target URIs (except when xref `type="none"` ). If xref `type="embed"` or `type="transclude"` with a PSML target URI, it recursively processes the target URI’s xrefs as well (if target is a fragment, it only follows xrefs for that fragment).

Invoking this service starts an [Asynchronous process](../usage/asynchronous_process.md).

## Parameters

| Name | Description | Required | Type | Default value |
| --- | --- | --- | --- | --- |
| description | The version content | no | string |  |
| labels | General labels for comment (e.g. `Important`, `Typo`) | no | labels |  |
| name | The version number or name | yes | string |  |
| notify | Send notification flag, e.g. `silent`, `normal`, `announce` | no | string | `silent` |
| notify-async | Whether emails are sent asynchronously (for slow email servers) | no | boolean | `false` |

## Permission

Requires approver in the group of the publication root document.

## Response

```xml

<version-creation>
  <thread id="123" ...>[thread XML]</thread>
</version-creation>
```

## Error Handling

| Code | Cause / Description |
| --- | --- |
| 0x122E | The labels parameter is invalid |