Skip To Content
ArcGIS Developers
Dashboard

/updateCategories: Update Group Items with Content Categories

  • URL:https://[root]/content/groups/[groupID]/updateCategories(POST only)

Example Usage

URL for Update Group Items With Content Categories

https://www.arcgis.com/sharing/rest/content/groups/826ab72ed44c48beb8735c2634e0bfad/updateCategories

Description

The Update Group Items With Content Categories operation (POST only) allows group owner and managers to add or remove group content categories on group items. A maximum of 100 items can be bulk updated per request.

Request Parameters

ParameterDetails
[Common Parameters]

For a complete listing, see Common parameters.

items

A JSON array of item objects, specified with each item's ID assigned with an array of group categories to update on the item.

Each item can be categorized to a maximum of 20 categories.

Example:

[{
	"2e63e6318c23482386ffc344e73e3636": ["/Categories/Basemaps/Esri Basemaps/Esri Vector Basemap", "/Region/World"]
}, {
	"c979ff16584b45eba6aad3d150a6b72f": ["/Region/US", "/Categories/Imagery/Temporal Imagery"]
}, {
	"2fc8267f964348fe834d59d958c26a7b": []
}]

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 whether the item was successfully updated. If an error occurs during updating an item, an error object is also returned.

Example:

[
  {
    "itemId": "c3ad4ed8bcf04d619537cfe252a1760d",
    "success": false,
    "error": {
      "code": 400,
      "message": "Item does not exist or is inaccessible."
    }
  },
  {
    "itemId": "9ced00fdce3e4b20bb4b05155acbe817",
    "success": true
  },
  {
    "itemId": "2678d3002eea4e4a825e3bdf10016e61",
    "success": true
  }
]

JSON Response Syntax

{"results": [
  {
    "itemId": "<itemId1>",
    "success": true | false
  },
  {
    "itemId": "<itemId2>",
    "success": true | false,
    "error": {
      "code": <error code>,
      "message": "<error message>"
    }
  },
  {
    "itemId": "<itemId3>",
    "success": true | false
  }
]}

JSON Response Example

{"results": [
  {
    "itemId": "c979ff16584b45eba6aad3d150a6b72f",
    "success": true
  },
  {
    "itemId": "2fc8267f964348fe834d59d958c26a7b",
    "success": true
  },
  {
    "itemId": "2e63e6318c23482386ffc344e73e3636",
    "success": true
  }
]}