- URL:https://[root]/portals/[portalID]/update(POST only)
Example usage
Below is a sample ArcGIS Enterprise POST request for the update operation:
POST /webadaptor/sharing/rest/portals/0123456789ABCDEF/update HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
name=ArcGIS Enterprise&description=<br/>&featuredItemsGroupQuery=thumbnail=culture=en&cultureFormat=region=units=english&homePageFeaturedContentCount=homePageFeaturedContent=basemapGalleryGroupQuery=templatesGroupQuery=layerTemplatesGroupQuery=symbolSetsGroupQuery=colorSetsGroupQuery=analysisLayersGroupQuery=livingAtlasGroupQuery=title:"Living Atlas" AND owner:esri_livingatlas&stylesGroupQuery=2DStylesGroupQuery=featuredGroups=[{"owner":"admin","title":"Featured Maps and Apps"}]&defaultBasemap=defaultExtent=rotatorPanels=showHomePageDescription=backgroundImage=helpBase=metadataEditable=false&metadataFormats=useVectorBasemaps=true&bingKey=defaultUserCreditAssignment=-1&geocodeService=routeServiceLayer=geometryService=elevation3DService=printServiceTask={"templates":[{"layout":"MAP_ONLY","format":"PNG32","label":"Map Only"}],"url":"https://machine.domain.com/server/rest/services/Utilities/PrintingTools/GPServer/Export%20Web%20Map%20Task"}&closestFacilityService=asyncClosestFacilityService=serviceAreaService=asyncServiceAreaService=syncVRPService=asyncVRPService=geoenrichmentService=analysisService={"url":"https://machine.domain.com/server/rest/services/System/SpatialAnalysisTools/GPServer"}&trafficService=asyncRouteService=asyncODCostMatrixService=asyncLocationAllocationService=routingUtilitiesService=elevationService=elevationSyncService=hydrologyService=rasterAnalyticsService=orthoMappingService=orthomappingElevationService=rasterUtilitiesService={"url":"https://machine.domain.com/server/rest/services/Utilities/RasterUtilities/GPServer"}&locationTrackingService=geoanalyticsService=asyncGeocodeService={"url":"https://machine.domain.com/server/rest/services/Utilities/GeocodingTools/GPServer"}&packagingService={"url":"https://machine.domain.com/server/rest/services/Utilities/OfflinePackaging/GPServer"}&trafficDataService=odCostMatrixService=urlKey=urlHostname=canSearchPublic=true&canSharePublic=true&allowedOrigins=allowedExternalLinks=canShareBingPublic=authorizedCrossOriginDomains=allowedRedirectUris=access=public&allSSL=true&useStandardizedQuery=true&canSigninArcGIS=true&canSigninIDP=true&canSigninSocial=false&canSigninOIDC=true&commentsEnabled=false&maxTokenExpirationMinutes=-1&updateUserProfileDisabled=false¬ificationsEnabled=false&contacts=["admin"]&platformSSO=false&orgUrl=orgEmail=orgPhone=portalProperties={"homePage"="modernOnly"}&f=pjsonDescription
The update operation (POST) allows administrators only to update the organization information such as name, description, thumbnail, and featured groups.
Request parameters
| Parameter | Details |
|---|---|
| [Common Parameters] | For a complete listing, see Common parameters. |
| clearEmptyFields | Clears any fields that are passed in empty (for example, name, description). |
| f | The response format. The default format is html. Values: html | json | pjson |
Portal properties
| Parameter | Details |
|---|---|
| access | Determines who can view your organization as an anonymous user. Setting to public allows anonymous users to access your organization's custom URL. Setting to private restricts access to only members of your organization. The default is public. Values: private | public Example |
| allowedOrigins | An array of up to 100 web application domains to restrict CORS access to the ArcGIS Online REST API. |
| allowedRedirectUris | A JSON array of allowed redirect URIs which represent portal instances that you share secure content with. This will allow your organization users to be able to use enterprise logins to access the secured content through web applications hosted on these portals. |
| allSSL | Indicates if organization uses HTTPS. If true, all calls made against resources that belong to the organization will require HTTPS. The default is false. Values: true | false |
| analysisLayersGroupQuery | The query that identifies the group containing the layers shown in the Analysis Layers gallery for the analysis tools. |
| analysisService | Hosted geoprocessing services that perform analyses. |
| asyncClosestFacilityService | ArcGIS geoprocessing service for asynchronous closest-facility analysis. Example |
| asyncGeocode | ArcGIS geoprocessing service for performing batch geocoding asynchronously. Example |
| asyncLocationAllocationService | ArcGIS geoprocessing service for asynchronous location-allocation network analysis. Example |
| asyncODCostMatrixService | ArcGIS geoprocessing service for generating origin-destination cost matrices asynchronously. Example |
| asyncRouteService | ArcGIS geoprocessing service for asynchronous route analysis. Example |
| asyncServiceAreaService | ArcGIS geoprocessing service for asynchronous service-area analysis. Example |
| asyncVRPService | ArcGIS geoprocessing service for solving asynchronous vehicle routing problems. Example |
| authorizedCrossOriginDomains | An array of trusted servers that clients can send credentials to when making Cross-Origin Resource Sharing (CORS) requests to access web-tier secured services. |
| backgroundImage | The background image that displays behind all other components on the home page. Accept the default background image, specify a URL for a custom background image, or specify that no background image displays. |
| basemapGalleryGroupQuery | The query that identifies the group containing the web maps that display in the basemap gallery for Map Viewer. |
| bingKey | The Bing key to use for web maps using Bing Maps. |
| canSearchPublic | Allows members of the organization to search outside the organization. The default is true. Values: true | false Example |
| canShareBingPublic | The Bing key can be shared to the public and is returned as part of the portal's call (/sharing/rest/portals/<orgid>). This requires the access of the portal to be set as public. The canShareBingPublic property is not returned publicly but only shown to the users within the organization. |
| canSharePublic | Allows members of the organization to share outside the organization. The default is true. Values: true | false Example |
| canSigninArcGIS | Allows an organization with an enterprise IDP configured to be able to turn on or off the ArcGIS sign in. The default is true. Values: true | false |
| canSigninIDP | Allows an organization with an enterprise IDP configured to be able to turn on or off the enterprise sign in. The default is true. Values: true | false |
| clearEmptyFields | Clears any string fields that are passed in empty, i.e. description. Example |
| closestFacilityService | ArcGIS NAServer service for synchronous closest-facility analysis. Example |
| colorSetsGroupQuery | The query that identifies the group containing the color sets used for rendering in Map Viewer. |
| commentsEnabled | Allows the organization to disable commenting. The default is true. When commentsEnabled is false, comments are hidden and not removed. numComments is set to zero for all items in the organization. Calls to add a comment and view comments will fail. If the organization reenables comments, the comments display and numComments is restored. Values: true | false |
| contacts | An array of chosen administrators listed as points of contact whose email addresses will be listed as points of contact in the automatic email notifications sent to org members when they request password resets, help with their user names, modifications to their accounts, or any issues related to the allocation of credits to their accounts. Example |
| creditAssignments | Indicates if the organization has credit budgeting enabled. The default is disabled. Values: enabled | disabled |
| culture | The default locale (language and country) information. The format for the culture code is based on a language code and a country code separated by a dash:
Example |
| cultureFormat | The preferred number and date format defined according to CLDR (only applicable to English and Spanish, i.e. when culture is en or es). See Languages for supported formats. Example |
| defaultBasemap | The default basemap displayed in Map Viewer. |
| defaultDevBasemap | The default basemap displayed in Map Viewer for developer subscriptions. |
| defaultExtent | The default extent of the organization, used when users create a new web map. Example |
| defaultUserCreditAssignment | Default allocation of credits for new members. -1 for no allocated limit. Example |
| description | A description of the organization/portal and can be of any length. Example |
| devbasemapGalleryGroupQuery | The query that identifies the group containing the web maps that display in the basemap gallery for Map Viewer for developer subscriptions. |
| elevation3DService | Limited Error Raster Compression (LERC) elevation service used by ArcGIS Pro and Web Scene Viewer. Example |
| elevationService | ArcGIS geoprocessing service for elevation analysis. Example |
| elevationSyncService | ArcGIS geoprocessing service for synchronous elevation analysis. Example |
| featuredGroups | The featured groups for the organization highlighted on the Groups page. |
| featuredItemsGroupQuery | The query that identifies the group containing featured items for the gallery. Set a Group ID or, if null, the most viewed items in your organization are displayed in the gallery. |
| geocodeService | An array of ArcGIS geocode services to use for geosearch and batch geocoding. Example |
| geoenrichmentService | ArcGIS GeoenrichmentServer. Example |
| geometryService | ArcGIS GeometryServer to use for geometry functions. Example |
| helpBase | New at ArcGIS Enterprise 10.8.1. Determines how your organization accesses help topics, either from an installed or publically available source (enterprise.arcgis.com). By default, the source is set to use the locally installed help. When internet is available, you can enable the option to deliver help topics from Esri's public web help from the ArcGIS Enterprise portal home app (Organization > Settings > General). Note:When configured for web help, if culture is set to one of the supported documentation languages, the URL will automatically be appended with the correct language code. For example, if culture is en, the helpBase URL will be updated to https://enterprise.arcgis.com/en/. This change is reflected on the Portal Self resource page. See below for a list of supported documentation languages. To learn more about setting portal languages, see Configure General Settings. Example |
| homePageFeaturedContentCount | The number of featured items that can be displayed on the home page up to a max of 100. Integer only. |
| homePageFeaturedContent | The group that contains featured content to be displayed on the organization home page. |
| hydrologyService | ArcGIS geoprocessing service for hydrological analysis. Example |
| layerTemplatesGroupQuery | The query that identifies the group containing editing templates used in Map Viewer. |
| maxTokenExpirationMinutes | The maximum validity in minutes of tokens issued for users of the organization: -1 is the default and is a special value that indicates infinite timeout or permanent tokens. For tokens granted using OAuth2 authorization grant, it represents the maximum validity of refresh tokens. For access tokens, the maximum validity is the lower of two weeks or this value. |
| metadataEditable | Indicates if the organization has metadata enabled. If metadataEditable=true, all members of the organization can view the metadata. Only item owners and administrators can update metadata. If metadataEditable=false, no one in the organization can access the metadata. Values: true | false |
| metadataFormats | Metadata style used for organization. Default is iso19139. Values: fgdc | inspire | iso19139 | iso19139-3.2 | iso19115 Example: metadataFormats : iso19139-3.2 |
| mfaAdmins | An array of at least two designated administrators who receive requests to troubleshoot members' multifactor authentication issues. |
| mfaEnabled | Indicates if org members are allowed to choose whether to set up multifactor authentication for their individual accounts. |
| name | The name of the organization/portal. The character limit is 250. Example |
| orthomappingElevationService | ArcGIS image service used by Ortho Maker. Example |
| portalProperties | Stores properties specific to the organization, for example, the contact us link. If the organization is public, the properties are visible to anonymous users. |
| printServiceTask | ArcGIS PrintServer task to use for printing functionality. Example |
| rasterUtilitiesService | ArcGIS geoprocessing service that enables raster analysis and processing. Example |
| region | The region of the organization. |
| rotatorPanels | Custom HTML for the organization home page. |
| routeServiceLayer | ArcGIS NASever service for synchronous route analysis. Example |
| routingUtilitiesService | ArcGIS geoprocessing service that provides auxiliary information, such as travel modes, used by the different routing services. Example |
| serviceAreaService | ArcGIS NAServer service for synchronous service-area analysis. Example |
| showHomePageDescription | If true, the description of the organization displays on the home page. Values: true | false |
| symbolSetsGroupQuery | The query that identifies the symbol set group for rendering in Map Viewer. |
| syncVRPService | ArcGIS geoprocessing service for solving synchronous vehicle routing problems. |
| templatesGroupQuery | The query that identifies the template group used in the configurable apps gallery. |
| thumbnail | Enter the keyAdd Resource containing the thumbnail. Acceptable image formats are PNG, GIF, and JPEG. Example |
| trafficService | ArcGIS map service for displaying traffic speeds and traffic incidents. Example |
| units | Sets the units of measure for the organization users. The user default is derived from the organization's region. Set units to english for U.S. standards or metric. |
| updateUserProfileDisabled | Indicates whether organization members are allowed to edit their biographical information and who can see their profiles. Values: true | false |
| urlHostname | A custom URL for this portal. Example |
| urlKey | The prefix that will be used in the URL for this portal, for example, <urlkey>.maps.arcgis.com. |
| useStandardizedQuery | If true, only simple WHERE clauses that are compliant with SQL92 can be used when querying layers and tables. The recommended security setting is true. Values: true | false |
| useVectorBasemaps | If true, organization uses the Esri vector basemaps in supported ArcGIS apps and basemapGalleryGroupQuery will not be editable and will be set to the default query. Values: true | false |
Supported documentation languages
| Supported documentation language | Culture property |
|---|---|
Arabic | ar |
Brazilian Portugese | pt-BR |
French | fr |
German | de |
Italian | it |
Japanese | ja |
Korean | ko |
Polish | pl |
Russian | ru |
Simplified Chinese | zh-CN |
Spanish | es-ES |
Response properties
| Property | Details |
|---|---|
| success | Indicates if the operation was successful. |
| orgId | The ID of the modified organization. |
JSON Response syntax
{
"success": true | false,
"orgId": "<organization id>"
}JSON Response example
{
"success": true,
"orgId": "fa019fbbfbb845d08cc9f0acde6dd8af"
}