Skip To Content
ArcGIS Developer
Dashboard

/settings: Organization Settings

Example usage

The following is a sample ArcGIS Online request URL used to access the settings resource:

https://org.arcgis.com/sharing/rest/portals/012345678ABCDEF/settings?f=json

The following is a sample ArcGIS Enterprise request URL used to access the settings resource:

https://machine.domain.com/webadaptor/sharing/rest/portals/012345678ABCDEF/settings?f=json

Description

The settings resource is used to return a view of the portal's configuration as seen by the current users, either anonymous or logged in. Information returned by this resource includes helper services, allowed redirect URIs, and the current configuration for any access notices or information banners.

Starting at ArcGIS Enterprise 11.0, this resource will display the customized advanced portal options set using the portalConfigProperties parameter with the Update operation. Previously, administrators who needed to customize their portal's behavior would make updates to the editable version of the portal's configuration file (config.js). For a list of all the properties supported by portalConfigProperties, see Advanced portal configuration properties. These properties are not supported for ArcGIS Online.

Request parameters

ParameterDetails
f

The response format. The default response format is html.

Values: html | json | pjson

JSON Response example

The following sample JSON response demonstrates information returned by the settings resource for ArcGIS Online and ArcGIS Enterprise (for versions before 11.0) organizations.

{
  "allowedRedirectUris": [],  "helperServices": {
    "geoanalytics": {"url": "https://machine.domain.com/webadaptor/rest/services/System/GeoAnalyticsTools/GPServer"},
    "printTask": {
      "url": "https://machine.domain.com/webadaptor/rest/services/Utilities/PrintingTools/GPServer/Export%20Web%20Map%20Task",
      "templates": [
        {
          "label": "MAP_ONLY",
          "format": "PNG32",
          "layout": "MAP_ONLY"
        },
        {
          "label": "A3 Landscape",
          "format": "PNG32",
          "layout": "A3 Landscape",
          "layoutOptions": {"legend": false}
        },
        {
          "label": "A3 Portrait",
          "format": "PNG32",
          "layout": "A3 Portrait",
          "layoutOptions": {"legend": false}
        },
        {
          "label": "A4 Landscape",
          "format": "PNG32",
          "layout": "A4 Landscape",
          "layoutOptions": {"legend": false}
        },
        {
          "label": "A4 Portrait",
          "format": "PNG32",
          "layout": "A4 Portrait",
          "layoutOptions": {"legend": false}
        },
        {
          "label": "Letter ANSI A Landscape",
          "format": "PNG32",
          "layout": "Letter ANSI A Landscape",
          "layoutOptions": {"legend": false}
        },
        {
          "label": "Letter ANSI A Portrait",
          "format": "PNG32",
          "layout": "Letter ANSI A Portrait",
          "layoutOptions": {"legend": false}
        },
        {
          "label": "Tabloid ANSI B Landscape",
          "format": "PNG32",
          "layout": "Tabloid ANSI B Landscape",
          "layoutOptions": {"legend": false}
        },
        {
          "label": "Tabloid ANSI B Portrait",
          "format": "PNG32",
          "layout": "Tabloid ANSI B Portrait",
          "layoutOptions": {"legend": false}
        }
      ]
    },
    "analysis": {"url": "https://machine.domain.com/webadaptor/rest/services/System/SpatialAnalysisTools/GPServer"},
    "asyncGeocode": {"url": "https://machine.domain.com/webadaptor/rest/services/Utilities/GeocodingTools/GPServer"},
    "rasterUtilities": {"url": "https://machine.domain.com/webadaptor/rest/services/Utilities/RasterUtilities/GPServer"},
    "packaging": {"url": "https://machine.domain.com/webadaptor/rest/services/Utilities/OfflinePackaging/GPServer"},
    "geocode": [
      {
        "url": "http://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer",
        "northLat": "Ymax",
        "southLat": "Ymin",
        "eastLon": "Xmax",
        "westLon": "Xmin",
        "name": "ArcGIS World Geocoding Service",
        "batch": false,
        "placefinding": true,
        "suggest": true
      },
      {
        "url": "https://machine.domain.com/webadaptor/sharing/servers/b27f4b69892b4e6a80447dbb2ecdb0c1/rest/services/World/GeocodeServer",
        "name": "Esri World Batch Geocoder",
        "isEsriBatchGeocoder": true,
        "placeholder": "Find address or place",
        "singleLineFieldName": "SingleLine",
        "batch": true,
        "placefinding": true,
        "suggest": true,
        "zoomScale": 10000
      }
    ],
    "route": {"url": "https://machine.domain.com/webadaptor/sharing/servers/a76d029529c54bde88685a1b5c96b78c/rest/services/World/Route/NAServer/Route_World"},
    "closestFacility": {"url": "https://machine.domain.com/webadaptor/sharing/servers/421a15a78ac148e8914b68e0d0635e75/rest/services/World/ClosestFacility/NAServer/ClosestFacility_World"},
    "asyncClosestFacility": {"url": "https://machine.domain.com/webadaptor/sharing/servers/392214c475c94741b2aa16f3e48fe666/rest/services/World/ClosestFacility/GPServer/FindClosestFacilities"},
    "serviceArea": {"url": "https://machine.domain.com/webadaptor/sharing/servers/d1333d1279fa4ea0a0c43d1172b4d9b6/rest/services/World/ServiceAreas/NAServer/ServiceArea_World"},
    "asyncServiceArea": {"url": "https://machine.domain.com/webadaptor/sharing/servers/e90a5900ca6b4fca9d1d037880d30084/rest/services/World/ServiceAreas/GPServer/GenerateServiceAreas"},
    "syncVRP": {"url": "https://machine.domain.com/webadaptor/sharing/servers/f2f20ca4b9164849bfad76f63eeb9895/rest/services/World/VehicleRoutingProblemSync/GPServer/EditVehicleRoutingProblem"},
    "asyncVRP": {"url": "https://machine.domain.com/webadaptor/sharing/servers/5c617347d534417eb07cfc0d1dbd6c81/rest/services/World/VehicleRoutingProblem/GPServer/SolveVehicleRoutingProblem"},
    "geoenrichment": {"url": "https://machine.domain.com/webadaptor/sharing/servers/55556c4432194b4080227627cc7773bc/rest/services/World/GeoenrichmentServer"},
    "traffic": {"url": "https://machine.domain.com/webadaptor/sharing/servers/c2537af3808f480a92e8290bd368bd9b/rest/services/World/Traffic/MapServer"},
    "asyncRoute": {"url": "https://machine.domain.com/webadaptor/sharing/servers/3b1e8dbf51dd4e3087d92d753657d4bf/rest/services/World/Route/GPServer"},
    "asyncODCostMatrix": {"url": "https://machine.domain.com/webadaptor/sharing/servers/1035fa78118c495b937a0c360830a26a/rest/services/World/OriginDestinationCostMatrix/GPServer"},
    "asyncLocationAllocation": {"url": "https://machine.domain.com/webadaptor/sharing/servers/00435065c2d94a7dafabd294e32cf88b/rest/services/World/LocationAllocation/GPServer"},
    "routingUtilities": {"url": "https://machine.domain.com/webadaptor/sharing/servers/dcb347384df94f6db0d947478a9f32c0/rest/services/World/Utilities/GPServer"},
    "elevation": {"url": "https://machine.domain.com/webadaptor/sharing/servers/207e9dc64b48444fbd646d9347cc7b97/rest/services/Tools/Elevation/GPServer"},
    "elevationSync": {"url": "https://elevation.arcgis.com/arcgis/rest/services/Tools/ElevationSync/GPServer"},
    "hydrology": {"url": "https://machine.domain.com/webadaptor/sharing/servers/6f3ed9326038483c998f4ab80cffef49/rest/services/Tools/Hydrology/GPServer"},
    "orthomappingElevation": {"url": "https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer"},
    "geometry": {"url": "https://utility.arcgisonline.com/webadaptor/rest/services/Geometry/GeometryServer"},
    "defaultElevationLayers": [
      {
        "url": "https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer",
        "id": "globalElevation",
        "layerType": "ArcGISTiledElevationServiceLayer",
        "name": "Terrain3D"
      }
    ]
  },
  "anonymousAccessNotice": {
    "title": "Anonymous Access Notice Title",
    "text": "Anonymous Access Notice Text",
    "bgColorTitle": "red",
    "fontColorTitle": "white"
  },
  "authenticatedAccessNotice": {
    "title": "Anonymous Access Notice Title",
    "text": "Anonymous Access Notice Text",
    "bgColorTitle": "red",
    "fontColorTitle": "white"
  },
  "culture": "en",
  "featuredGroups": [
    {
      "owner": "admin",
      "title": "Featured Maps and Apps"
    }
  ],
  "helperServices": {
    "printTask": {
      "templates": [
        {
          "layout": "MAP_ONLY",
          "format": "PNG32",
          "label": "Map Only"
        }
      ],
      "url": "https://machine.domain.com/webadaptor/rest/services/Utilities/PrintingTools/GPServer/Export%20Web%20Map%20Task"
    },
    "analysis": {"url": "https://machine.domain.com/webadaptor/rest/services/System/SpatialAnalysisTools/GPServer"},
    "asyncGeocode": {"url": "https://machine.domain.com/webadaptor/rest/services/Utilities/GeocodingTools/GPServer"},
    "rasterUtilities": {"url": "https://machine.domain.com/webadaptor/rest/services/Utilities/RasterUtilities/GPServer"},
    "packaging": {"url": "https://machine.domain.com/webadaptor/rest/services/Utilities/OfflinePackaging/GPServer"}
  },
  "informationalBanner": {
    "title": "Informational Banner",
    "text": "Header Text",
    "bgColor": "red",
    "fontColor": "blue"
  },
  "livingAtlasGroupQuery": "title:\"Living Atlas\" AND owner:esri_livingatlas"
}

For ArcGIS Enterprise organizations at or after version 11.0, the portalConfigProperties property will also be returned in the JSON response:

{
  "analysisLayersGroupQuery": "title:\"Living Atlas Analysis Layers\" AND owner:esri_livingatlas",
  "culture": "en",
  "featuredGroups": [
    {
      "owner": "portaladmin",
      "title": "Featured Maps and Apps"
    }
  ],
  "helperServices": {
    "printTask": {"url": "https://RQAWinBI01Sv.ags.esri.com/gis/rest/services/Utilities/PrintingTools/GPServer/Export%20Web%20Map%20Task"},
    "analysis": {"url": "https://RQAWinBI01Sv.ags.esri.com/gis/rest/services/System/SpatialAnalysisTools/GPServer"},
    "asyncGeocode": {"url": "https://RQAWinBI01Sv.ags.esri.com/gis/rest/services/Utilities/GeocodingTools/GPServer"},
    "rasterUtilities": {"url": "https://RQAWinBI01Rs.ags.esri.com/gis/rest/services/Utilities/RasterUtilities/GPServer"},
    "packaging": {"url": "https://RQAWinBI01Sv.ags.esri.com/gis/rest/services/Utilities/OfflinePackaging/GPServer"},
    "symbols": {"url": "https://RQAWinBI01Sv.ags.esri.com/gis/rest/services/Utilities/Symbols/SymbolServer"},
    "geoanalytics": {"url": "https://RQAWinBI01Sv.ags.esri.com/gis/rest/services/System/GeoAnalyticsTools/GPServer"},
    "rasterAnalytics": {"url": "https://RQAWinBI01Rs.ags.esri.com/gis/rest/services/System/RasterAnalysisTools/GPServer"},
    "orthoMapping": {"url": "https://RQAWinBI01Rs.ags.esri.com/gis/rest/services/System/OrthomappingTools/GPServer"},
    "geocode": [
      {
        "url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/b6b12fa92bef4e6c9e5c8e73397a44ad/rest/services/World/GeocodeServer",
        "name": "ArcGIS World Geocoding Service",
        "isEsriBatchGeocoder": true,
        "placeholder": "Find address or place",
        "singleLineFieldName": "SingleLine",
        "batch": true,
        "placefinding": true,
        "suggest": true,
        "zoomScale": 10000
      }
    ],
    "route": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/89b437a511524660b9ed92f481efa39e/rest/services/World/Route/NAServer/Route_World"},
    "closestFacility": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/e65302eb12ce4b399da11d06d84548d1/rest/services/World/ClosestFacility/NAServer/ClosestFacility_World"},
    "asyncClosestFacility": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/4fa4a7f212384358b418e9402fd18280/rest/services/World/ClosestFacility/GPServer/FindClosestFacilities"},
    "serviceArea": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/e03b31e94d474a84b2d220cf67795cac/rest/services/World/ServiceAreas/NAServer/ServiceArea_World"},
    "asyncServiceArea": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/38cc3e101caf4a7d8d6d875936d1b877/rest/services/World/ServiceAreas/GPServer/GenerateServiceAreas"},
    "syncVRP": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/3880a1e9360b49568fb669524b67b7bb/rest/services/World/VehicleRoutingProblemSync/GPServer/EditVehicleRoutingProblem"},
    "asyncVRP": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/c94959a0e4b94cc9a76144c3581bb32b/rest/services/World/VehicleRoutingProblem/GPServer/SolveVehicleRoutingProblem"},
    "geoenrichment": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/e96632943fb944e89f71d52a58d13e57/rest/services/World/GeoenrichmentServer"},
    "traffic": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/19700c9af8944cd2b69e96d8986e0fc4/rest/services/World/Traffic/MapServer"},
    "trafficData": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/cd1e3611a5804290bd6943e29892c9b0/rest/services/World/TrafficFeeds/GPServer"},
    "asyncRoute": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/538b0aca5f7942e58b6f700660f5e6ff/rest/services/World/Route/GPServer"},
    "asyncODCostMatrix": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/025e57ca3bc04573856bc8364b078c89/rest/services/World/OriginDestinationCostMatrix/GPServer"},
    "odCostMatrix": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/d9a9e18e016d4b72bc31a11756668410/rest/services/World/OriginDestinationCostMatrix/NAServer/OriginDestinationCostMatrix_World"},
    "asyncLocationAllocation": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/57f0f4056a5e4cebab420b8d584047fc/rest/services/World/LocationAllocation/GPServer"},
    "routingUtilities": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/25b1dd20b162482ab49474881122375b/rest/services/World/Utilities/GPServer"},
    "elevation": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/45de292d672f4bc5a519ad9f6b4e4003/rest/services/Tools/Elevation/GPServer"},
    "elevationSync": {"url": "https://elevation.arcgis.com/arcgis/rest/services/Tools/ElevationSync/GPServer"},
    "hydrology": {"url": "https://rqawinbi01pt.ags.esri.com/gis/sharing/servers/0caffc93e47d45688a4293480310f317/rest/services/Tools/Hydrology/GPServer"},
    "orthomappingElevation": {"url": "https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer"}
  },
  "livingAtlasGroupQuery": "title:\"Living Atlas\" AND owner:esri_livingatlas",
  "portalConfigProperties": {
    "extentService": "https://services.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer",
    "footerLinks": [],
    "gcsBasemapService": "https://services.arcgisonline.com/ArcGIS/rest/services/ESRI_Imagery_World_2D/MapServer",
    "httpsDomains": [
      "arcgis.com",
      "arcgisonline.com",
      "esrikr.com",
      "premiumservices.blackbridge.com",
      "esripremium.accuweather.com",
      "gbm.digitalglobe.com",
      "firstlook.digitalglobe.com",
      "msi.digitalglobe.com"
    ],
    "longTokenExpiration": 20160,
    "restrictOrganizationPageToAdmin": false,
    "searchArcGISOnlineEnabled": true,
    "showCreateDashboard": true,
    "showInAppLauncher": [
      "ArcGIS Dashboards",
      "ArcGIS Enterprise Sites",
      "Track Viewer",
      "Ortho Maker",
      "ArcGIS Workforce",
      "ArcGIS QuickCapture Web Designer",
      "ArcGIS StoryMaps",
      "ArcGIS Experience Builder",
      "ArcGIS Field Maps",
      "ArcGIS Map Viewer",
      "ArcGIS Map Viewer Classic",
      "ArcGIS Dashboards Classic"
    ],
    "sceneViewerEnabled": true,
    "surveyUrl": "https://survey123.arcgis.com",
    "tokenExpiration": 120,
    "webAppBuilderEnabled": true,
    "configurePortalAGOEnv": "www.arcgis.com",
    "portalAGOConfigEnabled": true,
    "portalLivingAtlasConfigEnabled": true
  }
}