---
title: "Service: /members/{member}/groups/{group}/uris/{uri}/versions [POST]"
source: https://dev.pageseeder.com/api/services/create-uri-version-POST.html
description: "Creates a new version for a URI or folder. Requires a version name and approver permissions. Supports optional descriptions, labels, and notifications. Asynchronous for folders."
last_updated: 2026-09-02T11:36:09+10:00
document_type: api_endpoint
operation_id: version-POST
resource_id: version
path_template: /members/{member}/groups/{group}/uris/{uri}/versions
http_method: POST
api_category: version
implementation_version: 6.2005
api_since: 4.9500
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: N/A
generated_at: 2026-09-02
tokens: ~466
---

# /members/\{member\}/groups/\{group\}/uris/\{uri\}/versions \[POST\]

## Description

Create a new version.

Adds a version to a uri, or if the uri is a folder, the uris under it.

If the URI is a folder, this service starts an [asynchronous process](../usage/asynchronous_process.md).

## Parameters

| Name | Description | Required | Type | Default value |
| --- | --- | --- | --- | --- |
| name | The version number or name | yes | string |  |
| description | The version content | no | string |  |
| labels | General label values for comment (e.g. `Important`, `Typo`) | no | labels |  |
| notify | Send notification flag, e.g. `silent`, `normal`, `announce` | no | enum | `silent` |
| notify-async | Whether emails should be sent asynchronously (for slow email servers) | no | boolean | `false` |
| publicationid | The `ID` of the publication associated with the version | no | publicationid |  |

### Notify parameter

This parameter must be one of:

- `normal` – notify based on each members’ notification settings;
- `announce` – ignores members’ individual notifications settings;
- `silent` – no notification.

## Permission

This service requires approver or above.

## Response

If `uri` is a document, the output has the following format:

```xml

<version-creation [warning="[warning]"]
                  [notify-param-ignored=true"]>
  <version id="[id]"
           name="[version name]"
           created="[date/time]">
    <author id="12" ... >
      <fullname>John Jones</fullname>
    </author>
    <description>[content of version]</description>
    <labels>[labels]</labels>
  </version>
</version-creation>
```

If `uri` is a folder, the output is:

```xml

<version-creation>
  <thread ...> ... </thread>
</version-creation>
```

## Error Handling

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