Add Resources


The add resources operation (POST only) allows to add new file resources to an existing item, for example, an image that is used as custom logo for Report Template. All the files are added to resources folder of the item. File resources use storage space from your quota and are scanned for viruses. The item size is updated to include the size of added resource files. A maximum of 50 files can be added each request. Each file should be no more than 50 Mb.

Supported item types that allow adding file resources are: Vector Tile Service, Vector Tile Package, Style, Code Attachment, Report Template, Web Mapping Application, Feature Service, Web Map, Statistical Data Collection, Scene Service, Web Scene, Application, Mobile Application, Native Application, Native Application Template, Native Application Installer, Desktop Application, Map Service, Image Service, Hub Site Application, Hub Initiative, Hub Page, ArcGIS Pro Add In, Application Configuration, AppBuilder Widget Package, SQLite Geodatabase, Rule Package, Notebook, WFS, Geocoding Service, Data Store, Site Page, Site Application, StoryMap, Geoprocessing Service, Solution.

Supported file formats are: .json, .xml, .txt, .png, .pbf, .zip, .jpeg, .jpg, .gif, .bmp, .gz, .svg, .svgz, .geodatabase.

File resources must be updated in an HTTP multi-part request pursuant to IETF RFC1867.

The operation is only available to the item owner and the organization administrator.

Request Parameters

[Common Parameters]

For a complete listing, see Common parameters.


Multi-part HTTP parameter containing the binary file to upload.


(Optional) Folder name used as a prefix for file resources to be added after.

The added files can be accessed either by https://<item-url>/resources/<resourcesPrefix>/<resourcename> or https://<useritem-url>/resources/<resourcesPrefix>/<resourcename>.


(Optional) File name used to rename an existing file resource uploaded, or to be used together with text as file name for it.


(Optional) Text input to be added as a file resource, used together with fileName.


(Optional) If true, file resources added are extracted and files are uploaded to respective folders.

Default is false.


(Optional) Set file resource to be private regardless of the item access level, or revert it by setting it to inherit which makes the item resource have the same access as the item.

Supported values: private | inherit.

Response Properties


Indicates if the operation was successful.


The ID of the item that file resources were added to.


The owner of the item.


The ID of the folder where the item is, null if the item is in the root folder.

Example Usage

URL for Add Resources

JSON Response Syntax

  "success": true,
  "itemId": "<item id>",
  "owner": "<owner username>",
  "folder": "<folder id>"

JSON Response Example

  "success": true,
  "itemId": "0c66beb52dff4994be67937cdadbdbf1",
  "owner": "jsmith",
  "folder": null


{"error": {
 "code": 400,
 "messageCode": "CONT_0093",
 "message": "File type not allowed for addResources",
 "details": []