ArcGIS REST API - ArcGIS Services

URL:https://<versionmanagementservice-url>/create(POST only)
Version Introduced:10.6

Description

Create a named version off of DEFAULT. The version is associated with the specified feature service. During creation, the description and accessPermission (default is public) may be optionally set.

Request Parameters


Parameter	Details
f	Description: Optional parameter to specify the output format of the response. The default response format is html. Values: html \| json
versionName	Description: The name of the new version. Syntax: versionName = versionname
description	Description: Optional parameter to specify the description of the new version. Syntax: description = description for version
accessPermission	Description: Optional parameter to specify the access permissions of the new version. The default access permission is private. Values: private \| public \| protected \| hidden Example: private

JSON Response Syntax

{
  "versionInfo" : {
    "versionName": <versionName>,
    "versionGuid": <guid>,
    "versionId": <long>,
    "description": <description>,
    "creationDate": <dateTime>,
    "modifiedDate": <dateTime>,
    "reconcileDate": <dateTime>,
    "evaluationDate": <dateTime>,
    "commonAncestorDate": <dateTime>,

    "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

f=json
versionName=carolina
description=Version for new subdivision edits
accessPermission=private

JSON response:

{
 "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
}