Apply Edits (Operation)

URL	`http://<featurelayer-url>/applyEdits` (POST only)
Parent Resource	Layer

Description

This operation adds, updates and deletes features to the associated feature layer or table in a single call (POST only). The apply edits operation is performed on a feature service layer resource. The results of this operation are 3 arrays of edit results (for adds, updates, and deletes respectively). Each edit result identifies a single feature and indicates if the edits were successful or not. If not, it also includes an error code and an error description.

You can provide arguments to the Apply Edits operation as query parameters defined in the parameters table below.

Parameters

Parameter	Details
f	Description: The response format. The default response format is html. Values: html \| json
adds	Description: The array of features to be added. The structure of each feature in the array is same as the structure of the json feature object returned by the ArcGIS REST API. Features to be added to a feature layer should include the geometry. Records to be added to a table should not include the geometry. Syntax: [ <feature1>, <feature2> ] Example: [ { "geometry" : {"x" : -118.15, "y" : 33.80}, "attributes" : { "OWNER" : "Joe Smith", "VALUE" : 94820.37, "APPROVED" : true, "LASTUPDATE" : 1227663551096 } }, { "geometry" : { "x" : -118.37, "y" : 34.086 }, "attributes" : { "OWNER" : "John Doe", "VALUE" : 17325.90, "APPROVED" : false, "LASTUPDATE" : 1227628579430 } } ]
updates	Description: The array of features to be updated. The structure of each feature in the array is same as the structure of the json feature object returned by the ArcGIS REST API. The attributes property of the feature should include the object id (and the global id, if available) of the feature along with the other attributes: "attributes" : { "OBJECTID" : 37, "OWNER" : "Joe Smith", "VALUE" : 94820.37, "APPROVED" : true, "LASTUPDATE" : 1227667627940 } Features to be updated to a feature layer should include the geometry. Records to be added to a table should not include the geometry. Syntax: [ <feature1>, <feature2> ] Example: [ { "geometry" : {"x" : -118.15, "y" : 33.80}, "attributes" : { "OBJECTID" : 37 "OWNER" : "Joe Smith", "VALUE" : 94820.37, "APPROVED" : true, "LASTUPDATE" : 1227667627940 } }, { "geometry" : { "x" : -118.37, "y" : 34.086 }, "attributes" : { "OBJECTID" : 462 "OWNER" : "John Doe", "VALUE" : 17325.90, "APPROVED" : false, "LASTUPDATE" : 9269154204840 } } ]
deletes	Description: The object IDs of this layer / table to be deleted. Syntax: `deletes=<objectId1>, <objectId2>` Example: `deletes=37, 462`

Example Usage

Example 1: Add an array of features using the apply edits operation on a feature service layer resource http://sampleserver3.arcgisonline.com/ArcGIS/rest/services/SanFrancisco/311Incidents/FeatureServer/0/applyEdits

sample input for adds, represented by an array of features:

[
    {
      "attributes" : {
        "req_id" : "508389",
        "req_type" : "Graffiti Complaint - Public Property",
        "req_date" : "09\/19\/2009",
        "req_time" : "18:44",
        "address" : "11TH ST and HARRISON ST",
        "x_coord" : "6008925.0",
        "y_coord" : "2108713.8",
        "district" : "6",
        "status" : 1
      },
      "geometry" : {
        "x" : -122.41247978999991,
        "y" : 37.770630098000083
      }
    }
]

Example 2: Update an array of features using the apply edits operation on a feature service layer resource http://sampleserver3.arcgisonline.com/ArcGIS/rest/services/SanFrancisco/311Incidents/FeatureServer/0/applyEdits

sample input for updates, represented by an array of features:

[
    {
      "attributes" : {
	"objectid": 1234567
        "req_id" : "508389",
        "req_type" : "Graffiti Complaint - Private Property",
        "req_date" : "09\/19\/2009",
        "req_time" : "18:44",
        "address" : "11TH ST and HARRISON ST",
        "x_coord" : "6008925.0",
        "y_coord" : "2108713.8",
        "district" : "6",
        "status" : 2
      },
      "geometry" : {
        "x" : -122.41247978999991,
        "y" : 37.770630098000083
      }
    }
]

Example 3: Delete features using the apply edits operation on a feature service layer resource http://sampleserver3.arcgisonline.com/ArcGIS/rest/services/SanFrancisco/311Incidents/FeatureServer/0/applyEdits

The input for deletes is a list of objectIds of the features to be deleted.

JSON Response Syntax

{
  "addResults" : [
    {
      "objectId" : <objectId1>,
      "globalId" : <globalId1>,
      "success" : <true | false>,
      "error" : { //only if success is false
        "code" : <code1>,
        "description" : "<description1>",
      }
    },
    {
      "objectId" : <objectId2>,
      "globalId" : <globalId2>,
      "success" : <true | false>,
      "error" : { //only if success is false
        "code" : <code2>,
        "description" : "<description2>",
      }
    }
  ],
  "updateResults" : [
    {
      "objectId" : <objectId1>,
      "globalId" : <globalId1>,
      "success" : <true | false>,
      "error" : { //only if success is false
        "code" : <code1>,
        "description" : "<description1>",
      }
    },
    {
      "objectId" : <objectId2>,
      "globalId" : <globalId2>,
      "success" : <true | false>,
      "error" : { //only if success is false
        "code" : <code2>,
        "description" : "<description2>",
      }
    }
  ],
  "deleteResults" : [
    {
      "objectId" : <objectId1>,
      "globalId" : <globalId1>,
      "success" : <true | false>,
      "error" : { //only if success is false
        "code" : <code1>,
        "description" : "<description1>",
      }
    },
    {
      "objectId" : <objectId2>,
      "globalId" : <globalId2>,
      "success" : <true | false>,
      "error" : { //only if success is false
        "code" : <code2>,
        "description" : "<description2>",
      }
    }
  ]
}

JSON Response Example

{
  "addResults" : [
    {
      "objectId" : 37,
      "globalId" : null,
      "success" : true
    },
    {
      "objectId" : -1,
      "globalId" : null,
      "success" : false,
      "error" : {
        "code" : 50,
        "description" : "Cannot add unapproved parcels.",
      }
    }
  ],
  "updateResults" : [
    {
      "objectId" : 463,
      "globalId" : null,
      "success" : true
    },
    {
      "objectId" : 462,
      "globalId" : null,
      "success" : false,
      "error" : {
        "code" : 30,
        "description" : "'LASTUPDATED' date cannot be in the future.",
      }
    }
  ],
  "deleteResults" : [
    {
      "objectId" : 9,
      "globalId" : null,
      "success" : true
    },
    {
      "objectId" : 625,
      "globalId" : null,
      "success" : false,
      "error" : {
        "code" : 60,
        "description" : "Features whose last update was less than 2 days ago cannot be deleted.",
      }
    }
  ]
}