/update: Update Organization Information

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&notificationsEnabled=false&contacts=["admin"]&platformSSO=false&orgUrl=orgEmail=orgPhone=portalProperties={"homePage"="modernOnly"}&f=pjson

Description

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

name

The name of the organization/portal. The character limit is 250.

Example

name: City of Cloud Creek
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

access: private
description

A description of the organization/portal and can be of any length.

Example

description: City of Cloud Creek was founded in 1851 and is located on the banks of Cloud Creek, 
60 miles Northwest of Portland, Oregon. Cloud Creek prides itself on its historic charm and stunning natural setting. 
Since 1987, GIS technology has become an integral part of almost all of Cloud Creek's governmental functions. 
As the next step in the GIS evolution, Cloud Creek has an initiative to put all GIS maps online.
canSharePublic

Allows members of the organization to share outside the organization. The default is true.

Values: true | false

Example

canSharePublic: false
canSearchPublic

Allows members of the organization to search outside the organization. The default is true.

Values: true | false

Example

canSearchPublic: false
thumbnail

Enter the keyAdd Resourcecontaining the thumbnail. Acceptable image formats are PNG, GIF, and JPEG.

Example

thumbnail: logo.png
urlKey

The prefix that will be used in the URL for this portal, for example, <urlkey>.maps.arcgis.com.

urlHostname

A custom URL for this portal.

Example

urlHostname: mySite
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

culture: en–US
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

cultureFormat: us
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.

region

The region of the organization.

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.

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.

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.

basemapGalleryGroupQuery

The query that identifies the group containing the web maps that display in the basemap gallery for Map Viewer.

devbasemapGalleryGroupQuery

The query that identifies the group containing the web maps that display in the basemap gallery for Map Viewer for developer subscriptions.

templatesGroupQuery

The query that identifies the template group used in the configurable apps gallery.

layerTemplatesGroupQuery

The query that identifies the group containing editing templates used in Map Viewer.

symbolSetsGroupQuery

The query that identifies the symbol set group for rendering in Map Viewer.

colorSetsGroupQuery

The query that identifies the group containing the color sets used for rendering in Map Viewer.

analysisLayersGroupQuery

The query that identifies the group containing the layers shown in the Analysis Layers gallery for the analysis tools.

featuredGroups

The featured groups for the organization highlighted on the Groups page.

defaultBasemap

The default basemap displayed in Map Viewer.

defaultExtent

The default extent of the organization, used when users create a new web map.

Example

{
  "type": "extent",
  "xmin": -14999999.999998225,
  "ymin": 2699999.9999996624,
  "xmax": -6199999.999999268,
  "ymax": 6499999.999998959,
  "spatialReference": {
    "wkid": 102100
  }
}
rotatorPanels

Custom HTML for the organization home page.

showHomePageDescription

If true, the description of the organization displays on the home page.

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.

geocodeService

An array of ArcGIS geocode services to use for geosearch and batch geocoding.

Example

[
  {
    "url": "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer",
    "northLat": "Ymax",
    "southLat": "Ymin",
    "eastLon": "Xmax",
    "westLon": "Xmin",
    "name": "Esri World Geocoder",
    "batch": true,
    "placefinding": true,
    "suggest": true
  },
  {
    "singleLineFieldName": "SingleLine",
    "url": "https://sampleserver.domain.com/arcgis/rest/services/Locators/serviceName/GeocodeServer",
    "name": "Locator Name",
    "placeholder": "",
    "placefinding": true,
    "batch": true,
    "zoomScale": 10000
  }
]
routeServiceLayer

ArcGIS NASever service for synchronous route analysis.

Example

{
  "url": "https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World",
  "defaultTravelMode": "FEgifRtFndKNcABC"
}
geometryService

ArcGIS GeometryServer to use for geometry functions.

Example

{
  "url": "https://utility.arcgisonline.com/arcgis/rest/services/Geometry/GeometryServer"
}
elevation3DService

Limited Error Raster Compression (LERC) elevation service used by ArcGIS Pro and Web Scene Viewer.

Example

[
  {
    "url": "https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer",
    "id": "globalElevation",
    "layerType": "ArcGISTiledElevationServiceLayer"
  }
]
printServiceTask

ArcGIS PrintServer task to use for printing functionality.

Example

{
  "url": "https://utility.arcgisonline.com/arcgis/rest/services/Utilities/PrintingTools/GPServer/Export%20Web%20Map%20Task"
}
closestFacilityService

ArcGIS NAServer service for synchronous closest-facility analysis.

Example

{
  "url": "https://route.arcgis.com/arcgis/rest/services/World/ClosestFacility/NAServer/ClosestFacility_World",
  "defaultTravelMode": "FEgifRtFndKNcABC"
}
asyncClosestFacilityService

ArcGIS geoprocessing service for asynchronous closest-facility analysis.

Example

{
  "url": "https://logistics.arcgis.com/arcgis/rest/services/World/ClosestFacility/GPServer/FindClosestFacilities",
  "defaultTravelMode": "FEgifRtFndKNcABC"
}
serviceAreaService

ArcGIS NAServer service for synchronous service-area analysis.

Example

{
  "url": "https://route.arcgis.com/arcgis/rest/services/World/ServiceAreas/NAServer/ServiceArea_World",
  "defaultTravelMode": "FEgifRtFndKNcABC"
}
asyncServiceAreaService

ArcGIS geoprocessing service for asynchronous service-area analysis.

Example

{
  "url": "https://logistics.arcgis.com/arcgis/rest/services/World/ServiceAreas/GPServer/GenerateServiceAreas",
  "defaultTravelMode": "FEgifRtFndKNcABC"
}
syncVRPService

ArcGIS geoprocessing service for solving synchronous vehicle routing problems.

{
  "url": "https://logistics.arcgis.com/arcgis/rest/services/World/VehicleRoutingProblemSync/GPServer/EditVehicleRoutingProblem",
  "defaultTravelMode": "FEgifRtFndKNcABC"
}
asyncVRPService

ArcGIS geoprocessing service for solving asynchronous vehicle routing problems.

Example

{
  "url": "https://logistics.arcgis.com/arcgis/rest/services/World/VehicleRoutingProblemSync/GPServer/EditVehicleRoutingProblem",
  "defaultTravelMode": "FEgifRtFndKNcABC"
}
geoenrichmentService

ArcGIS GeoenrichmentServer.

Example

{
  "url": "https://geoenrich.arcgis.com/arcgis/rest/services/World/GeoenrichmentServer"
}
analysisService

Hosted geoprocessing services that perform analyses.

trafficService

ArcGIS map service for displaying traffic speeds and traffic incidents.

Example

{
  "url": "https://traffic.arcgis.com/arcgis/rest/services/World/Traffic/MapServer"
}
asyncRouteService

ArcGIS geoprocessing service for asynchronous route analysis.

Example

{
  "url": "https://logistics.arcgis.com/arcgis/rest/services/World/Route/GPServer",
  "defaultTravelMode": "FEgifRtFndKNcABC"
}
asyncODCostMatrixService

ArcGIS geoprocessing service for generating origin-destination cost matrices asynchronously.

Example

{
  "url": "https://logistics.arcgis.com/arcgis/rest/services/World/Route/GPServer",
  "defaultTravelMode": "FEgifRtFndKNcABC"
}
asyncLocationAllocationService

ArcGIS geoprocessing service for asynchronous location-allocation network analysis.

Example

{
  "url": "https://logistics.arcgis.com/arcgis/rest/services/World/LocationAllocation/GPServer",
  "defaultTravelMode": "FEgifRtFndKNcABC"
}
routingUtilitiesService

ArcGIS geoprocessing service that provides auxiliary information, such as travel modes, used by the different routing services.

Example

{
  "url": "https://logistics.arcgis.com/arcgis/rest/services/World/Utilities/GPServer"
}
elevationService

ArcGIS geoprocessing service for elevation analysis.

Example

{
  "url": "https://elevation.arcgis.com/arcgis/rest/services/Tools/Elevation/GPServer"
}
elevationSyncService

ArcGIS geoprocessing service for synchronous elevation analysis.

Example

{
  "url": "https://elevation.arcgis.com/arcgis/rest/services/Tools/ElevationSync/GPServer"
}
hydrologyService

ArcGIS geoprocessing service for hydrological analysis.

Example

{
  "url": "https://hydro.arcgis.com/arcgis/rest/services/Tools/Hydrology/GPServer"
}
asyncGeocode

ArcGIS geoprocessing service for performing batch geocoding asynchronously.

Example

{
  "url": "https://analysis1.arcgis.com/arcgis/rest/services/tasks/GPServer"
}
orthomappingElevationService

ArcGIS image service used by Ortho Maker.

Example

{
  "url": "https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer"
}
rasterUtilitiesService

ArcGIS geoprocessing service that enables raster analysis and processing.

Example

{
  "url": "https://utility.arcgisonline.com/arcgis/rest/services/Utilities/RasterUtilities/GPServer"
}
bingKey

The Bing key to use for web maps using Bing Maps.

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.

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.

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

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

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

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

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.

mfaEnabled

Indicates if org members are allowed to choose whether to set up multifactor authentication for their individual accounts.

mfaAdmins

An array of at least two designated administrators who receive requests to troubleshoot members' multifactor authentication issues.

metadataEditable

Indicates if the organization has metadata enabled.

Values: true | false

creditAssignments

Indicates if the organization has credit budgeting enabled. The default is disabled.

Values: enabled | disabled

defaultUserCreditAssignment

Default allocation of credits for new members. -1 for no allocated limit.

Example

defaultUserCreditAssignment: 500
updateUserProfileDisabled

Indicates whether organization members are allowed to edit their biographical information and who can see their profiles.

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.

metadataFormats

Metadata style used for organization.

Example

metadataFormats: iso19139-3.2
clearEmptyFields

Clears any string fields that are passed in empty, i.e. description.

Example

clearEmptyFields: true
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

contacts: ["admin1","admin2","admin3"]
helpBase

New at ArcGIS Enterprise 10.8.1. Determines how your organization accesses the help topics, either from a locally installed source or via the web version of the user documentation (enterprise.arcgis.com). By default, the source is set to use the locally installed help. When web help access is enabled from the ArcGIS Enterprise portal home app (Organization > Settings > General), this field will be updated to show the URL path for the web help.

NoteNote:

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

helpBase: https://enterprise.arcgis.com/

Supported documentation languages

Supported documentation language

Culture property

German

de

Spanish

es-ES

French

fr

Japanese

ja

Russian

ru

Simplified Chinese

zh-CN

Arabic

ar

Italian

it

Korean

ko

Polish

pl

Brazilian Portugese

pt-BR

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