- URL:https://<root>/services/exists(POST only)
- Required Capability:Default administrator role | Security and infrastructure | Update | Delete | Publisher role
- Version Introduced:10.9
Description
The exists operation checks whether a folder or service exists in the organization. It is recommended that you run this operation before creating a folder or a service. If a folder with the same folder name, or a service with the same name and type, exists in the organization, the response will return the exists property as true. If no conflicting folder or service is found, the exists property returns as false.
Request parameters
Parameter | Details |
---|---|
folderName (Optional, or required when checking for existing folders) | The name of the folder. Example
|
serviceName (Optional, or required when checking for existing services) | The name of the service. Example
|
type (Optional, or required when checking for existing services) | The type of service. Example
|
f | The response format. The default response is html. Values: html | json | pjson |
Example usage
The following is a sample POST request for the exists operation:
POST /context/admin/services/exists HTTP/1.1
Host: organization.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
folderName=&serviceName=CommercialDamage&type=FeatureServer&f=pjson&token=Mb0ORrkLObNO2Q8FZoUCHHzSMzZi0CbhLHNRYMqqa6URG_ojQJF3rNsJAfRB23MyCrLwSmuaHPUo4AEIrUuoH1-4Ot5xh4565FtlQahXAhK2C7Sy0oydZhBwD8KdFSnVlnLr-e9uI5ovSWZ2lGNn9SwoV2MPMzeAh_5r-q-wgwF8DTT_nhuCXJGkMRy-48jjGS2aN5FI18STHZ8RAuKxGasH90SI3C7njZzlGCUrY5m6BDhCMsdpZA14GwNX8Cis
JSON Response example
{
"folderName": "",
"serviceName": "CommercialDamageAssessment",
"type": "FeatureServer",
"exists": true
}