Skip To Content

Create Version

Description

License:

The ArcGIS Location Referencing license is required to use this resource.

Note:

This endpoint is deprecated starting at ArcGIS Server 11.2.

Versioning endpoints in this API—including Create Version, Reconcile Version, and Delete Version—are provided for ArcMap publishing.

In ArcGIS Pro publishing, versioning is handled by the Version Management Service, which is required for feature service publishing using branch versioning. This capability handles all ArcGIS Pro versioning-related operations.

Creates a new version in an enterprise geodatabase. The version will have public access.

Version names are case sensitive and should take the form {owner}.{version}, for example, sde.DEFAULT.

Request parameters

ParameterDetails
f

Optional parameter to specify the response format. The default response format is html.

Values: html | json

name

Required

Description: Name of the version to create. This must not have any owner prefix.

parentVersion

Required

Description: Name of an existing version on which to base the new child version. This must be a full version name with an owner prefix.

description

Description: A description of the new version.

lrsId

A unique ID that identifies an LRS workspace. Refer to the LRS service resource for a list of LRS workspaces and their IDs.

If there is only one LRS workspace referenced by the map service, that LRS is used by default. Otherwise, the lrsId parameter is required.

Example usage

Example 1

URL for creating version 'Job_42' with parent version 'sde.DEFAULT' in the default LRS workspace.

https://sampleserver/arcgis/rest/services/MyLRS/MapServer/exts/LRServer/createVersion?f=json&name=Job_42&parentVersion=sde.DEFAULT

Example 2

URL for creating version 'Job_42' with parent version 'dbo.LockRoot' in the LRS workspace '387ad279-6026-4680-8171-fd17d1b9efd4'.

https://sampleserver/arcgis/rest/services/MyLRS/MapServer/exts/LRServer/createVersion?f=json&name=Job_42&parentVersion=dbo.LockRoot&lrsId=387ad279-6026-4680-8171-fd17d1b9efd4

JSON Response syntax

{
  "versionName" : "<versionName>"  // the full version name, including the owner
}

JSON Response example

{
  "versionName" : "sde.Job_42"
}