---
title: "Service: /members/{member}/groups/{group}/uris/forurl/versions [POST]"
source: https://dev.pageseeder.com/api/services/create-uri-version-forurl_post.html
description: "POST endpoint to create a new version for a URI or folder within a member's group. Requires version name and URL, with optional description, labels, and notification settings. Returns version details or thread info for folders."
last_updated: 2026-09-08T14:00:21+10:00
document_type: api_endpoint
operation_id: version-POST
resource_id: version
path_template: /members/{member}/groups/{group}/uris/forurl/versions
http_method: POST
api_category: version
implementation_version: 6.2005
api_since: 6.0008
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: N/A
generated_at: 2026-09-02
tokens: ~477
---

# /members/\{member\}/groups/\{group\}/uris/forurl/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 |  |
| url | The URL for the URI | yes | url |  |

### 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 |