Version Infos | ArcGIS REST APIs

URL:: https://<root>/<serviceName>/VersionManagementServer/versionInfos
Methods:: POST
Version Introduced:: 10.6

Description

The versionInfos operation returns the information for all versions that the current user has access to. The versions are also filtered for the specified feature service.

Learn more about version access for branch versions

Request parameters

Parameter Details

Parameter	Details
`f`	Specifies the output format of the response. The default response format is `html`. Values: `html` \| `json` \| `pjson`
`ownerFilter` (Optional)	Specifies a filter for the versions by owner. Syntax: `ownerFilter=<userIdentity>`
`includeHidden` (Optional)	Specifies whether versions with hidden access will be returned. The default is `false`. Values: `true` \| `false`
`nameFilter` (Optional)	Specifies a filter for the versions by name. Syntax: `nameFilter=<name>`

f

Specifies the output format of the response. The default response format is html.

Values: html | json | pjson

ownerFilter

(Optional)

Specifies a filter for the versions by owner.

Syntax: ownerFilter=<userIdentity>

includeHidden

(Optional)

Specifies whether versions with hidden access will be returned. The default is false.

Values: true | false

nameFilter

(Optional)

Specifies a filter for the versions by name.

Syntax: nameFilter=<name>

JSON Response syntax

Use dark colors for code blocksCopy
{
 "versions": [
  "versionName": <versionName>,
  "versionGuid": <guid>,
  "description": <description>,
  "creationDate": <dateTime>,
  "modifiedDate": <dateTime>,
  "reconcileDate": <dateTime>,
  "evaluationDate": <dateTime>,
  "previousAncestorDate": <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

Return information for versions owned by the unadmin user using the versionInfos operation.

Request URL and parameters:

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

Use dark colors for code blocksCopy
f=json
ownerFilter=unadmin
includeHidden=false

JSON response:

Use dark colors for code blocksCopy
{
 "versions": [
  {
   "versionName": "unadmin.project2a",
   "versionGuid": "{496C55E1-86EA-4F06-8FC8-8D5BBCBD7761}",
   "description": "Created from the rest endpoint",
   "creationDate": 1549926318552,
   "modifiedDate": 1549926318552,
   "reconcileDate": null,
   "evaluationDate": null,
   "previousAncestorDate": null,
   "commonAncestorDate": 1549926318552,
   "access": "public"
  },
  {
   "versionName": "unadmin.project2b",
   "versionGuid": "{E8EBB6AE-F7D8-45B2-806E-D745943682FC}",
   "description": "Created from the rest endpoint",
   "creationDate": 1549926344967,
   "modifiedDate": 1549926344967,
   "reconcileDate": null,
   "evaluationDate": null,
   "previousAncestorDate": null,
   "commonAncestorDate": 1549926344967,
   "access": "public"
  }
 ],
 "success": true
}