Create | ArcGIS REST APIs | Esri Developer

URL:: https://<root>/<serviceName>/VersionManagementServer/create
Methods:: POST
Required Capability:: Edit privilege (features:user:edit)
Version Introduced:: 10.6

Description

Create a version off of DEFAULT. The version is associated with the specified feature service.

Request parameters

Parameter	Details
`f`	Specifies the output format of the response. The default response format is `html`. Values: `html \| json` \| `pjson`
`versionName` (Required)	Specifies the name of the new version. The version name cannot exceed 62 characters or include any of the following special characters: Period (.) Semicolon (;) Single quotation mark (') Double quotation mark (") Syntax: Use dark colors for code blocksCopy `1 versionName = <versionName>`
`description` (Optional)	Specifies the description of the new version. Ensure the description does not exceed 64 characters. Example: Use dark colors for code blocksCopy `1 description = description for version`
`accessPermission` (Optional)	Specifies the access permissions of the new version. The default access permission is `private`. Values: `private` \| `public` \| `protected` \| `hidden` Example: Use dark colors for code blocksCopy `1 accessPermission = private`
`moment` (Optional)	Specifies the moment that will be the common ancestor of the version. The `moment` value must be greater than the `modifiedDate` of the default version and less than the current moment. When not specified, the date/time of the create operation is used. Syntax: Use dark colors for code blocksCopy `1 moment = <unix timestamp in milliseconds>` Example: Use dark colors for code blocksCopy `1 moment = 1603109596000` This parameter was introduced in ArcGIS Enterprise 12.1.

JSON Response syntax

Use dark colors for code blocksCopy
{
  "versionInfo" : {
    "versionName": <versionName>,
    "versionGuid": <guid>,
    "versionId": <long>,
    "description": <description>,
    "creationDate": <unix timestamp in milliseconds>,
    "modifiedDate": <unix timestamp in milliseconds>,
    "reconcileDate": <unix timestamp in milliseconds>,
    "evaluationDate": <unix timestamp in milliseconds>,
    "commonAncestorDate": <unix timestamp in milliseconds>,
    "access" : "private" | "public" | "protected"
  },
  "success" : <true | false>,
  "error" : { // only if success is false
    "extendedCode" : <HRESULT>,
    "message" : <error message>,
    "details" : [ <detail> ]
  }
}

Example usage

Create a named version using the create operation.

Request URL and parameters:

https://myserver.esri.com/server/rest/services/LandUse/VersionManagementServer/create

Use dark colors for code blocksCopy
f=json
versionName=carolina
description=Version for new subdivision edits
accessPermission=private

JSON response:

Use dark colors for code blocksCopy
{
 "versionInfo": {
  "versionName": "portaluser.carolina",
  "versionGuid": "{30AD6543-16CD-4291-89CA-E734199EE231}",
  "versionId": 2,
  "description": "Version for new subdivision edits",
  "creationDate": 1567540025752,
  "modifiedDate": 1567540025752,
  "reconcileDate": null,
  "evaluationDate": null,
  "previousAncestorDate": null,
  "commonAncestorDate": 1567540025752,
  "access": "private"
 },
 "success": true
}