- URL:https://<externalcontent-url>/update(POST only)
- Required Capability:Default administrator role | Organization website
- Version Introduced:11.0
Description
The update operation enables and disables access to Esri-provided content containing external URLs that reference sites and resources hosted outside of the organization. If external content is disabled, Esri content containing external URLs will be removed from the organization and will not be discoverable. This extends to any external content that would typically be included when enabling new languages for your organization; that is, when access to external content is disabled, all external content included with any added languages is also disabled.
If you enable external content, Esri content containing external URLs is added to the organization and is discoverable. By default, external content is enabled. This extends to any external content included when enabling new languages for the organization, enabling access to external content included with added languages.
Note:
For organizations upgrading to ArcGIS Enterprise on Kubernetes 11.0 from an earlier version, an administrator must manually set the externalContentEnabled property to disable external content after the upgrade. However, ArcGIS Enterprise on Kubernetes will honor the values set for externalContentEnabled when upgrading to later versions from 11.0.
Request parameters
| Parameter | Details |
|---|---|
| externalContentEnabled | Specifies whether the organization will allow Esri-provided external content. If true, outside resources and sites will be accessible to users in your organization. If false, access to this content will be unavailable. The default value is true. Values: true | false |
| f | The response format. The default format is html. Values: html | json | pjson |
Example usage
The following is a sample POST request for the update operation:
POST /context/admin/system/content/externalcontent/update HTTP/1.1
Host: organization.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
externalContentEnabled=false&f=pjson&token=pTF08-CHWCTee06taPxsNFRbqe6oAmq-WsyD-cOITvUXypJemoP8I_8rPZltViyfP46PmKhkicCgt8dMK5m-4H02kpkIGnUG5yxIgOfkoQRyZ9y3bMhVnkGnh24YU-KDKTI6QQI0kDASxSPWl_ntPevBHbqhORrxLgauHDHoRBCm48fEswZTOyZwQdozczzYbS3wKKecRT66v9ssoRmtmiYLREY4B_nkRfTEZoQSwr6w7LzqLAO5k3wwB3orC1LRJSON Response example
{"status": "success"}