Skip To Content
ArcGIS Developer

/update: Update Item

  • URL:https://[root]/content/users/[userName]/items/[itemID]/update(POST only)

Example Usage


The Update Item operation (POST only) allows users to update an item's information and file, URL, or text, depending on type. Users can use this operation to update item information such as title, description, tags, and so on, or use it to update an item's file, URL, or text. This call is available to the user and the administrator of the organization.

The parameters that are to be updated need to be specified in the request. Parameters not specified will not be affected.

All parameters for this operation are optional.

Upload of files can be done asynchronously or in multiple parts. See Add Item for more information.

Request parameters


The title of the item. This is the only name that users and applications use for the title, as there is no concept of display names or aliases in the API.


The path to the thumbnail image to be used for the item. For best results, images that are 600 pixels wide by 400 pixels high or larger with an aspect ratio of 1.5:1 are recommended. Supported file formats are PNG, GIF, and JPEG with a maximum file size of 10 MB. The file will be stored on the sharing servers.

Supported retrievable thumbnail widths for item are 200 pixels (default), 400 pixels, 800 pixels, and 2400 pixels, with an aspect ratio of 1.5:1. Other specified sizes will be snapped to the next highest supported dimension for query. If the original image dimension is smaller than the size queried, the original image will be returned.



Item thumbnails can be retrieved at different dimensions by specifying a URL parameter w for the desired image width:


Enter the URL to the thumbnail image to be used for the item. The recommended image size is 200 pixels wide by 133 pixels high. Acceptable image formats are PNG, GIF, and JPEG. The maximum file size for an image is 1 MB.


The file that stores the metadata information for an item. It's stored in the metadata folder under esriinfo, for example,<itemid>/info/metadata/metadata.xml.



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


Metadata style used for organization. Default is iso19139.

Values: fgdc | inspire | iso19139 | iso19139-3.2 | iso19115


metadataFormats : iso19139-3.2


Type keywords describe the type and should logically apply to all items of that type. See Items and Item types for a list of predefined type keywords that will be automatically added based on the supplied type. This parameter should be used only if you want to add additional type keywords. Keywords can be applied to any type of item, in addition to hosted feature services.


<keyword1>, <keyword2>



An item description. The size of the description needs to be less than 63 KB.


This application represents point locations within the United States and Canada for common institution landmark types including hospitals, educational institutions, religious institutions, government centers, and cemeteries.

Tags are words or short phrases that describe the specific item, separated by commas.


<tag1>, <tag2>


landmarks, United States, Canada

Snippet or summary for the item. Limit this brief descriptive text to 2048 characters.


Landmarks in United States and Canada

The bounding rectangle of the item.


<xmin>, <ymin>, <xmax>, <ymax>


-110.05, 44.13, -110, 44.98

The coordinate system of the item.



The source credits for the item.

Copyright:© 2008 ESRI, AND, TANA, ESRI Japan, UNEP-WCMC

Includes any license information or restrictions.

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 United States License

The item locale (language and country) information. The browser locale will not be taken into consideration if the culture parameter is used to update an item. The format for a culture code is based on a language code and country code, separated by a dash. The language code is based on the two-letter codes found in the Library of Congress Codes for the Representation of Names of Languages. The country code is based on the two-letter codes found by searching the ISO Online Browsing Platform.



A JSON object that primarily applies to system requirements, terms and conditions, version, supported platforms, and video IDs associated with the application.

If the item is of type notebook, you can specify the runtime version of the notebook.

Notebook example:

properties: {"notebookRuntimeName":"ArcGIS Notebook Python 3 Standard","notebookRuntimeVersion":"5.0"}


The URL of the item to be updated.


Sets the user name on a secure, on-premises map, feature, or image service.


Sets the password on a secure, on-premises map, feature, or image service.


A JSON object that provides rate limiting and referrer checks when accessing secured services.



A JSON object with category, sourceCountry, and searchExtent properties that are used to restrict service item response results based on specified filters, such as limiting results returned from a geocode service based on defined filters. This parameter is only applicable to geocoding service item types. The category property is a comma-delimited list of one or more categories from the geocoding service. The sourceCountry property is a 2- or 3-digit country code supported by the geocoding service. The searchExtent property is a JSON envelope object that is used to limit geocoding to a specified search area. The three properties (category, sourceCountry, and searchExtent) can be used independently or in any combination; they are applied as a Boolean AND operator when combined.


  "sourceCountry": "USA",
  "searchExtent": {
    "xmin": -13184700,
    "ymin": 3988556,
    "xmax": -13004945,
    "ymax": 4061479,
    "spatialReference": {
      "wkid": 102100

  "category" : "MGRS"

If true, a service URL item is updated as a proxy item without embedding credentials. It can be used to take advantage of the portal sharing model for security reasons, hide actual service URLs, rate limiting and referrer checks, and so on.

Values: true | false


Allows users to remove the service proxy created for an item (true). The default value is false.

Values: true | false


An array that primarily applies to a list of categories that the application item is applicable to.


Clears any fields that are passed in empty (true). The default value is false.

Values: true | false


A JSON array or comma-separated list of categories to add to the item.

//Format one
["/Categories/Basemaps", "/Categories/Transportation"]

//Format two
/Categories/Basemaps, /Categories/Transportation

An array that primarily applies to industries associated with the application.


An array that primarily applies to languages associated with the application.


Primarily applies to thumbnails associated with an application. The URL to the thumbnail is used for the application.


Primarily applies to the banner associated with an application. The URL to the banner is used for the application.


An array that primarily applies to screen shots associated with an application. The URL to the screen shots is used for the application.


A JSON object that consists of listing properties when the item is listed in ArcGIS Marketplace. For more information on syntax and properties, see Listing properties.


The file to be updated.


If true, the file is uploaded asynchronously. If false, the file is uploaded synchronously. This only applies to item types that require files. The default value is false.

Values: true | false


The JSON content for the item to be updated.



The URL where the item can be downloaded. The resource will be downloaded and stored as a file type. This is similar to uploading a file to be added, but instead of transferring the contents of the file, the URL of the data file is referenced and creates a file item.

Please see the implementation details section below which discusses this parameter in further details.


If true, the file is uploaded in multiple parts. See the description above for more information.

Values: true | false


The name of the file being uploaded in multipart mode. This parameter is required if the file is being uploaded in multiple parts and the multipart parameter is set as true.


The response format. The default format is html.

Values: html | json | pjson

Implementation details for using the dataUrl parameter

  • The referenced dataUrl parameter has to be an unsecured URL where data can be downloaded.
  • This operation is asynchronous; therefore, the client should check the item's status before using. If the status is completed, the resource is downloaded and the file item is added successfully.
  • If the resource supports byte ranges and the content length is larger than 500 KB, Range GET requests are used to download the file in parts.
  • Multiple parallel threads download the file parts and perform a file-based merge on them. This is not performed in-memory in order to avoid buffering. If a part can't be downloaded, it attempts once more before failing. All parts need to be downloaded successfully before the item can be created.

Service proxy parameters

ArcGIS Online and ArcGIS Enterprise users can register premium services, as well as services published on their own server, as secured service proxies. If working with secured services, you have the option to save the user name and password credentials directly with the item. Setting the serviceProxyParams provides additional control over how these services are accessed by supplying rate limiting and referrer checks. In other words, by setting these parameters, you provide more control over who can access these services and how much they can use them.

The serviceProxyParams JSON object used to set rate limiting and referrer checks on secured services is described below.


Number of requests that will be allowed within a specified time interval of intervalInSeconds. Default value is 2.


Integer value indicating the interval time in seconds. Default value is 60.


Array of referrers allowed to access service.

A sample serviceProxyParams JSON object is as follows:

  "https://*] //* allows any subdomain from to be added

Response example

If the rate limit is exceeded, an error will be returned:


Both hitsPerInterval and IntervalSeconds need to be greater than zero (0) for rate limiting to work.

  "error": {
    "code": 429,
    "messageCode": "CONT_0049",
    "message": "Rate limit exceeded. Please try again later.",
    "details": []

Response properties


Indicates if the operation was successful.


The ID of the updated item.


Below is a sample POST request for ArcGIS Enterprise that demonstrates how to update a feature service.

POST /webadaptor/sharing/rest/content/users/serviceOwner/items/2b4c7a08699146f0b270ab609ec4aa91/update HTTP/1.1
Content-Type: multipart/form-data; boundary=----boundary
Content-Length: []

Content-Disposition: form-data; name="title"

Content-Disposition: form-data; name="thumbnail"; filename=""
Content-Type: application/octet-stream

Content-Disposition: form-data; name="thumbnailUrl"

Content-Disposition: form-data; name="metadata"; filename=""
Content-Type: application/octet-stream

Content-Disposition: form-data; name="typeKeywords"

ArcGIS Server, Data, Feature Access, Feature Service, Service, Hosted Service
Content-Disposition: form-data; name="description"

This map is used to monitor the state of fires surrounding the Inland Empire area and should be used as a resource for safety officials and residents.
Content-Disposition: form-data; name="tags"

feature service, fire, fire watch, Inland Empire
Content-Disposition: form-data; name="snippet"

Fires and their containment status within the Inland Empire
Content-Disposition: form-data; name="extent"

-117.7976, 33.7443, -116.7834, 34.2351
Content-Disposition: form-data; name="spatialReference"

Content-Disposition: form-data; name="accessInformation"

Content-Disposition: form-data; name="licenseInfo"

Content-Disposition: form-data; name="culture"

Content-Disposition: form-data; name="properties"

Content-Disposition: form-data; name="url"
Content-Disposition: form-data; name="serviceUsername"

Content-Disposition: form-data; name="servicePassword"

Content-Disposition: form-data; name="serviceCredentialsType"

Content-Disposition: form-data; name="serviceProxyParams"

Content-Disposition: form-data; name="serviceProxyFilter"

Content-Disposition: form-data; name="appCategories"

Content-Disposition: form-data; name="categories"

Content-Disposition: form-data; name="industries"

Content-Disposition: form-data; name="languages"

Content-Disposition: form-data; name="largeThumbnail"; filename=""
Content-Type: application/octet-stream

Content-Disposition: form-data; name="banner"; filename=""
Content-Type: application/octet-stream

Content-Disposition: form-data; name="screenshot"; filename=""
Content-Type: application/octet-stream

Content-Disposition: form-data; name="screenshot"; filename=""
Content-Type: application/octet-stream

Content-Disposition: form-data; name="screenshot"; filename=""
Content-Type: application/octet-stream

Content-Disposition: form-data; name="screenshot"; filename=""
Content-Type: application/octet-stream

Content-Disposition: form-data; name="listingProperties"

Content-Disposition: form-data; name="file"; filename=""
Content-Type: application/octet-stream

Content-Disposition: form-data; name="text"

Content-Disposition: form-data; name="dataUrl"

Content-Disposition: form-data; name="f"


JSON Response syntax

  "success": true | false,
  "id": "<item id>"

JSON Response example

  "success": true,
  "id": "b512083cd1b64e2da1d3f66dbb135956"