Skip To Content
ArcGIS Developer


  • URL:https:// <service-uploads-url>/register (POST only)
  • Required Capability:Uploads (Image service requires Edit)
  • Version Introduced:10.0


This operation registers an item that will be uploaded in multiple parts. Once an item is registered parts of the item must be uploaded using the uploadPart operation. Once all parts are uploaded, the commit operation must be used to complete the upload of that item.

See section limiting Upload file size and file types to learn more about default file size and file type limitations imposed for uploads.

Users can provide arguments to the register operation as query parameters. The parameter details are provided in the parameters table below.

Request parameters


The response format. The default response format is html.

Values: html | json


A name for the item to be registered.


An optional description for the registered item.

Example usage

Register an item:

JSON Response syntax

    "success": <true|false>,
    "item": {
        "itemID": "<itemID>",
        "itemName": "<itemName>",
        "description": "<description>",
        "date": <date>,
        "committed": <false>

JSON Response example

    "success": true,
    "item": {
        "itemID": "ib740c7bb-e5d0-4156-9cea-12fa7d3a472c",
        "itemName": "LakeTahoeImage",
        "description": "Lake Tahoe",
        "date": 1246060800000,
        "committed": false