/deleteItems: Delete Items

URL:
https://[root]/content/users/[userName]/deleteItems
Methods:
POST

Example Usage

The following is a sample ArcGIS Online POST request for the deleteItems operation:

Use dark colors for code blocksCopy
1
2
3
4
5
6
POST /sharing/rest/content/users/jsmith/deleteItems HTTP/1.1
Host: org.arcgis.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

items=93b54c8930ae46d9a00a7820cb3ebbd1,bb8e3d443ab44878ab8315b00b0612ca&permanentDelete=false&f=pjson

The following is a sample ArcGIS Enterprise POST request for the deleteItems operation:

Use dark colors for code blocksCopy
1
2
3
4
5
6
POST /<context>/sharing/rest/content/users/jsmith/deleteItems HTTP/1.1
Host: organization.example.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

items=93b54c8930ae46d9a00a7820cb3ebbd1,bb8e3d443ab44878ab8315b00b0612ca&f=pjson

Description

The deleteItems operation deletes a batch of items.

For ArcGIS Online organizations, the deletedItems operation moves all the supported items to the recycle bin for 14 days before they are permanently deleted. Any unsupported items in the batch are permanently deleted. Learn more about permanently deleting and restoring items.

Request Parameters

ParameterDetails

items

A comma separated list of items to be deleted.

permanentDelete

This parameter was introduced in the ArcGIS Online June 2024 update. Deletes a batch of items permanently. The default is false. Any unsupported items in the batch are permanently deleted even if the value is set to false.

Values: true | false

f

The response format. The default format is html.

Values: html | json | pjson

Response Properties

PropertyDetails

results

An array of JSON objects, one for each item requested. Each object is made up of the itemId and a success flag to indicate if the item was successfully deleted. If an error occurs when deleting an item, an error object is also returned.

JSON Response Syntax

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
{"results": [{
  "itemId": "<item  id>",
  "success": true | false,
  "error": {
      "code": code,
      "message": "<error message>"
    }
}]
}

JSON Response Example

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
{"results": [
  {
    "itemId": "93b54c8930ae46d9a00a7820cb3ebbd1",
    "success": true,
  },
  {
    "itemId": "bb8e3d443ab44878ab8315b00b0612ca",
    "success": false,
    "error": {
      "code": 500,
      "message": "Item does not exist or is inaccessible"
    }
  }
]}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.