/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

Parameter	Details
[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

Property

Details

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
  }
]}