- URL:
- https://[root]/content/users/[userName]/addItem
- Methods:
POST
Example usage
The following is a sample ArcGIS Online POST request for the add
operation:
POST /sharing/rest/content/users/jsmith/addItem HTTP/1.1
Host: org.arcgis.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Length: []
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="file"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="url"
https://www.mymappingapplication.com
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="text"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="dataUrl"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="title"
My Mapping Application
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="thumbnail"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="thumbnailUrl"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="metadata"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="type"
Web Mapping Application
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="categories"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="typeKeywords"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="description"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="tags"
web, mapping, application
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="snippet"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="licenseinfo"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="culture"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="properties"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="advancedSettings"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="extent"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="callback.html"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="originItemId"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="destinationItemId"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="relationshipType"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="serviceUsername"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="servicePassword"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="serviceCredentialsType"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="serviceProxyParams"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="serviceProxyFilter"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="appCategories"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="industries"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="languages"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="largeThumbnail"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="banner"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="screenshot"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="screenshot"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="screenshot"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="screenshot"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="listingProperties"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="itemIdToCreate"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="f"
pjson
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="token"
IrJJfqrMHKhCqEupZPKe5T8PO2AQX5T7ZpO7z6A0vW3C79IeazSsnW2_vSGNY60V4gCwhDjTm_WMJ-yVzn5aJ0aq6I5QfuHUxVZpSfDMAfyGTGcGZoDYI6hHuJsP3nul2KrFZvfz_rVacrJvmc1gBqFExMA0x_fYcrCd8kx7J9Na9kesExs7s2Yn8dL9G0NY
------WebKitFormBoundarypyRY2U6MeTT2TgqN--
The following is a sample ArcGIS Enterprise POST request for the add
operation:
POST /webadaptor/sharing/rest/content/users/jsmith/addItem HTTP/1.1
Host: machine.domain.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Length: []
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="file"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="url"
https://www.mymappingapplication.com
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="text"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="dataUrl"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="title"
My Mapping Application
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="thumbnail"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="thumbnailUrl"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="metadata"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="type"
Web Mapping Application
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="categories"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="typeKeywords"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="description"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="tags"
web, mapping, application
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="snippet"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="classification"
{"classification": "In-confidence","banner": "In-confidence//Legal Privilege/To be reviewed on 2025-05-05","distribution": "Legal Privilege","reviewDate": "2025-05-05"}
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="licenseinfo"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="culture"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="properties"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="advancedSettings"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="extent"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="callback.html"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="originItemId"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="destinationItemId"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="relationshipType"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="serviceUsername"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="servicePassword"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="serviceCredentialsType"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="serviceProxyParams"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="serviceProxyFilter"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="appCategories"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="industries"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="languages"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="largeThumbnail"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="banner"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="screenshot"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="screenshot"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="screenshot"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="screenshot"; filename=""
Content-Type: application/octet-stream
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="listingProperties"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="itemIdToCreate"
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="f"
pjson
------WebKitFormBoundarypyRY2U6MeTT2TgqN
Content-Disposition: form-data; name="token"
IrJJfqrMHKhCqEupZPKe5T8PO2AQX5T7ZpO7z6A0vW3C79IeazSsnW2_vSGNY60V4gCwhDjTm_WMJ-yVzn5aJ0aq6I5QfuHUxVZpSfDMAfyGTGcGZoDYI6hHuJsP3nul2KrFZvfz_rVacrJvmc1gBqFExMA0x_fYcrCd8kx7J9Na9kesExs7s2Yn8dL9G0NY
------WebKitFormBoundarypyRY2U6MeTT2TgqN--
Description
The add
operation allows a user to upload an item file, submit text content, or submit the item URL to the specified user folder depending on documented items and item types.
This operation is available only to the specified user. This operation also allows users to optionally create a relationship and share an item in one call. The same rules apply, with the following exceptions:
- If you specify an
origin
, the new item is added as the destination item.Item Id - If you specify a
destinationitem
, the new item is added as the origin item.Id - If you specify both, an error is returned.
- The destination item will inherit all the sharing permissions of the origin item.
The relationship creation is finished after the item is created. If the item isn't added correctly, no relationship is created. However, if the item is added correctly, but the relationship fails (that is, it's a bad relationship type, invalid origin or destination item, and so on), the item is deleted.
Additional considerations
The following sections outline additional behaviors or features for the add
that should be considered before performing this operation
Asynchronous uploads
Large files take a long time to process when uploaded. Rather than processing the request to add an item synchronously, this operation can be performed asynchronously. In this mode, the client checks back with the server for the job's status. To utilize asynchronous mode, the async
parameter should be set to true
. Once the request is submitted, the JSON response will return the item ID of the added item, as well as the request's current status and status message:
{
"status": "processing",
"statusMessage": "processing",
"itemId": "ddb1838f5a76478894698d371be3a2b6"
}
The status can be checked using the Status operation. When polled, the status can return as one of three possible states: processing
, completed
, or failed
. The status message will return information relevant to the job's current status. For example, the status message below details why the request failed:
{
"status": "failed",
"statusMessage": "Item 'mexicoWebMercator.sd' already exists."
"itemId": "ddb1838f5a76478894698d371be3a2b6"
}
Multipart uploads
Clients that have the ability to split large files into smaller parts can utilize multipart uploads. To initiate a multipart upload, the multipart parameter should be set to true. When uploading multiple file parts, only the multipart and filename parameters are required. All other parameters will be ignored. Once the multipart upload has been initiated, the Add Part operation is used to upload each part of the file, which are then committed to complete the upload.
No item properties can be passed into the multipart call. If the uploaded file is not a package that includes item information, the Update Item operation must be called to update the item's information.
Chunked transfer encoding
The use of chunked transfer encoding is not recommended. There is an upload limit of 50mb when using chunked transfer. Because the size of an upload cannot be checked prior to transfer, the operation may fail unexpectedly if the limit is reached.
Item information
If the item is an uploaded .zip
file, or an ArcGIS package, and it contains an esriinfo
folder, all files and subfolders in the esriinfo
folder will be extracted and available through the Item Info File resource. To demonstrate, the example below represents the structure of an uploaded .zip
file:
Zip file (*.mpk, *.lpk)
|-- esriinfo (folder)
|-- iteminfo.xml (item card)
|-- subfolder
|-- thumbnail.jpg
The iteminfo.xml
in the structure above will be available from the Item Info File resource:
https://machine.domain.com/webadaptor/sharing/rest/content/items/[itemID]/info/iteminfo.xml
The iteminfo.xml
file represents the item card. Users can provide some basic information for the item, such as the item's name, title, thumbnail in this file. If you specify the thumbnail and documentation properties in this item card, they must be paths relative to the esriinfo
folder. In the above case, the thumbnail must be specified as follows:
<ESRI_ItemInformation>
...
<thumbnail>subfolder/thumbnail.jpg</thumbnail>
...
</ESRI_ItemInformation>
However, you do not need to bundle this information with the file at the time of uploading. This information can be submitted as query parameters (such as name
and title
) along with the file
or url
parameters. This information can also be specified using the Update Item operation.
In addition to thumbnail information being returned in the iteminfo.xml
file, the thumbnail file is available at the following location:
https://server/sharing/rest/content/items/<itemId>/info/<subfolder>/thumbnail.jpg
Request parameters
Parameter | Details |
---|---|
| The file to be uploaded. If uploading a file, the request must be a multipart request. |
| The URL where the item can be downloaded. The resource will be downloaded and stored as a file type. 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. The referenced URL must be an unsecured URL where the data can be downloaded. This parameter requires the operation to be performed asynchronously. Once the job status returns as complete, the item can be downloaded and the item is added successfully. If the item supports Byte Ranges, and the content length is larger than 500kb, a Range GET is 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 cannot be downloaded, the system will attempt once more before failing. All parts must be downloaded successfully before the item can be created. |
| The URL of the item to be submitted. The URL can be a URL to a service, a web mapping application, or any other content available at that URL. Example:
|
| The JSON content for the item to be submitted. Example:
|
| The type of relationship between the two items. See Relationship types for a complete listing of types. Example:
|
| The item ID of the origin item of the relationship. Example:
|
| The item ID of the destination item of the relationship.
|
| If Values: |
| The file name being uploaded in multipart mode. Required if Values: |
| A JSON object that provides rate limiting and referrer checks when accessing secured services. For more information on Example:
|
| If Values: |
| New at ArcGIS Enterprise 10.8.1. The item ID of the item. The item ID must not exist and must be 32 alphanumeric values. Example:
|
| The title of the item. This is the only name that users and applications use for the item. There is no concept of display names or aliases in the Sharing API. The item title is limited to 256 alphanumeric characters. Example:
|
| The pathname to the thumbnail image to be used for the item. For best results, images that are 600 x 400 pixels 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. This will not be a reference to the file but the file itself that is stored on the sharing servers. Item thumbnail can be retrieved at different dimensions by specifying a URL parameter Example:
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. Example:
|
| The URL to the thumbnail image to be used for the item. The recommended image size is 200 x 133 pixels. Acceptable image formats are PNG, GIF, and JPEG. The maximum file size for an image is 1 MB. Example:
|
| The file that stores the metadata information on an item. It's stored in the metadata folder under
Example:
|
| Indicates if the organization has metadata enabled. If Values: |
| Metadata style used for organization. The default style is Values: |
| The type of the item. Must be drawn from the list of supported types. See Items and item types for a list of the supported types. Example:
|
| Adds additional type keywords to the item. Type keywords describe the type and should logically apply to all items of that type. Type keywords can be applied to any type of item, including hosted feature services. See Items and item types for a list of the different predefined type keywords that will be automatically added based on the supplied type. Syntax:
Example:
|
| An item description less than 64 Kb. Example:
|
| A comma-delimited list of tags for the item. Tags are words or short phrases that describe the specific item. Syntax:
Example:
|
| Snippet or summary for the item. Limit this brief descriptive text to 2048 characters. Example:
|
| Introduced at ArcGIS Enterprise 11.4. The classification marking for an item. The JSON object should contain properties related to the attributes specified in the schema and reference a valid value for each attribute. The JSON object must include a Example:
|
| The item's bounding rectangle. Example:
Example:
|
| The coordinate system of the item. Example:
|
| Credits the source of the item. Example:
|
| Includes any license information or restrictions. Example:
|
| The item locale (language and country) information. If the added item is a package, the culture parameter in the 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 at 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, YouTube video ID, etc associated with the application. |
| An array that primarily applies to a list of categories that the application item is applicable to. |
| An array that primarily applies to industries associated with the application. |
| An array that primarily applies to languages associated with the application. |
| The URL to the thumbnail used for the application. This parameter primarily applies to thumbnail associated with an application. |
| The URL to the banner used for the application. This parameter primarily applies to the banner associated with an application. |
| The URL to the screenshots used for the application. This parameter primarily applies to screenshots associated with an application. |
| A JSON object consists of listing properties when the item is listed in ArcGIS Marketplace. For information on the
|
| Set the username on a secure on-premise ArcGIS Server service. It is valid on Map Services, Feature Services and Image Services only. Example:
|
| Set the password on a secure on-premise ArcGIS Server service. It is valid on Map Services, Feature Services, and Image Services only. Example:
|
| A JSON object with Syntax:
Example:
|
| A JSON array or comma separated list of categories to add to the item. Example:
|
| If Values: |
| The response format. The default format is Values: |
Listing properties
A listing is specified as a JSON object. Its syntax and properties are as follows:
Property | Details |
---|---|
| The type of license offered by the listing. The Values: |
| Indicates whether the listing is Values: |
| Text that describes the pricing details of this listing. This property is not required for free listings. |
| The number of credits that will be charged to the customer per transaction. This property only applies to consumption-based listings. |
| Indicates whether or not the listing supports trials. Values: |
| Duration of the trial (in days). This property only applies when |
| Indicates whether or not the listing is e-commerce enabled. Values: |
| Listing licensing model. The default is Values: |
Service proxy properties
ArcGIS Online and ArcGIS Enterprise portal 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 username and password credentials directly with the item. Setting the service
provides additional control over how these services are accessed by supplying rate limiting and referrer checks. In other words, by setting these limitations, you provide more control over who can access these services and how much they can use them.
The service
JSON object used to set rate limiting and referrer checks on secured services is described below.
Property | Details |
---|---|
| Number of requests that will be allowed within a specified time interval of |
| Integer value indicating the interval time in seconds. The default value is 60. |
| Array of referrers allowed to access service. |
The example below demonstrates a sample service
JSON object:
{
"hitsPerInterval":2,
"intervalSeconds":60,
"referrers":["https://server1","https://server2","https://*.arcgis.com"] //*.arcgis.com allows any subdomain from arcgis.com to be added
}
When service
has been defined, if the rate limit is exceed an error message will be returned:
{
"error": {
"code": 429,
"messageCode": "CONT_0049",
"message": "Rate limit exceeded. Please try again later.",
"details": []
}
}
Additional example usage
Add a reference to a .csv file
The following examples for ArcGIS Online and ArcGIS Enterprise are sample POST requests that demonstrate using the add
operation to add a reference to a .csv
file.
ArcGIS Online:
POST /sharing/rest/content/users/jsmith/addItem HTTP/1.1
Host: org.arcgis.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
dataUrl=https://mysharedserver/CSV/restaurants.csv&title=Restaurants&type=CSV&tags=restaurants, web
ArcGIS Enterprise:
POST /webadaptor/sharing/rest/content/users/jsmith/addItem HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
dataUrl=https://mysharedserver/CSV/restaurants.csv&title=Restaurants&type=CSV&tags=restaurants, web
Add item using the data store's information
The following example for ArcGIS Enterprise is sample POST requests that demonstrate adding a data store item to a portal with the data store's JSON information. The sample request below have been formatted for readability.
POST /webadaptor/sharing/rest/content/users/jsmith/addItem HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
https://machine.domain.com/webadaptorname/sharing/rest/content/users/jsmith/addItem&text={
"type": "cloudstore",
"info": {
"isManaged": false,
"connectionString": {
"accessKeyId": "example_input_key",
"secretAccessKey": "secret_key",
"region": "us-west-2",
"defaultEndpointProtocol": "https",
"credentialType": "accesskey"
},
"objectStore": "bucketName/folderName"
},
"path": "/cloudStores/storeName",
"provider": "amazon"
}&title=myCloudStore&type=Data Store
JSON Response properties
Property | Details |
---|---|
| Indicates if the operation was successful |
| The ID of the created item. |
| The folder in which the item was created. |
JSON Response syntax
{
"success": true | false,
"id": "<item id>",
"folder": <folder id>
}
JSON Response example
{
"success": true,
"id": "17dd19b627b74068a6f3292c7ae0d88a",
"folder": null
}