[username]: User Content

URL:: https://[root]/content/users/[username]
Methods:: GET
Operations:: Add Item, Add Item Part, Add Relationship, Can Reassign Items, Can Recycle Item, Can Restore, Cancel, Commit, Copy Item, Create Folder, Create Service, Delete Folder, Delete Info, Delete Items, Delete Relationships, Export, Folder, Folder Item, Move Items, Publish, Reassign Items, Replace Service, Restore, Share Items, Unshare Items, Update Folder
Child Resources:: Delete Folder Item, User Item

Example usage

The following is a sample ArcGIS Online request URL used to access the user content resource:

Use dark colors for code blocksCopy
https://org.arcgis.com/sharing/rest/content/users/jsmith?start=11&num=50&f=pjson

The following is a sample ArcGIS Enterprise request URL used to access the user content resource:

Use dark colors for code blocksCopy
https://machine.domain.com/webadaptor/sharing/rest/content/users/jsmith?start=11&num=50&f=pjson

Description

The user content resource returns information on the user's owned items. A user's content are items stored either in their root content folder (e.g. /content/users/<username>) or in a subfolder of the home folder with the given folder ID. Multilevel folders are not supported. Items in a folder are stored by reference and are not physically in a folder. Rather, they're stored as links to the original item (e.g. /content/items/<itemId>).

Request parameters

Parameter	Details
`[Common Parameters]`	For a complete listing, see Common parameters.
`start` (Optional)	The number of the first entry in the result set response. The index number is 1-based. The default value of `start` is `1`. Example: Use dark colors for code blocksCopy `1 start=11`
`num` (Optional)	The maximum number of results to be included in the result set response. The default value is `10`, and the maximum allowed value is `100`. Note that the actual number of returned results may be less than `num`. This happens when the number of results remaining after `start` is less than `num`. Example: Use dark colors for code blocksCopy `1 2 //Returns a max of 50 results in the response num=50`
`foldersContent`	Return items from all user folders. If `false`, only items from the root are returned. Values: `true` \| `false`
`ignoreTypes`	A filter used to ignore or exclude item types that are specified by the user. Use dark colors for code blocksCopy `1 Example: https://org.arcgis.com/sharing/rest/content/users/jsmith/1851c185888a43fcb3d6fffb78ae7c94?f=pjson&ignoreTypes=Web Map,Feature Service`
`inRecycleBin`	Returns all items from the recycle bin. The default is `false`. This parameter was introduced in the ArcGIS Online June 2024 update. Values: `true` \| `false` Example: Returns all items in recycle bin for a user under root folder Use dark colors for code blocksCopy `1 https://org.arcgis.com/sharing/rest/content/users/jsmith?foldersContent=true&inRecycleBin=true` Returns items in recycle bin for a user with filter Use dark colors for code blocksCopy `1 https://org.arcgis.com/sharing/rest/content/users/jsmith?foldersContent=true&types=Web Map,Feature Service&inRecycleBin=true` Returns items in recycle bin for a user with ignore filter Use dark colors for code blocksCopy `1 https://org.arcgis.com/sharing/rest/content/users/jsmith?foldersContent=true&ignoreTypes=Web Map,Feature Service&inRecycleBin=true` Note Available only for ArcGIS Online organizations. For a list of unsupported items in the recycle bin, see here.
`types`	Filter by item type. Multiple types can be filtered using commas. Item type is case sensitive. See items and item types for reference. Use dark colors for code blocksCopy `1 Example: https://org.arcgis.com/sharing/rest/content/users/jsmith/1851c185888a43fcb3d6fffb78ae7c94?f=pjson&Types=Web Map,Feature Service`

Response properties

Property	Details
`username`	The username of the content.
`total`	The total number of results found for the whole query.
`start`	The number of the first entry in the result set for this response. The index number is 1-based. Note If the `start` or `num` parameters are not provided, the results are paginated and will display 1000 items per page.
`num`	The number of results included in the result set for this response. Note If the `start` or `num` parameters are not provided, the results are paginated and will display 1000 items per page.
`nextStart`	The next entry index if the current result set doesn't contain all results, or -1 if it is the last batch.
`currentFolder`	The current folder listing the user's items.
`items`	The list of the user's items. See Item for response properties for more details.
`[folders] username`	The username of the owner of the folder.
`id`	The folder ID.
`title`	The folder title.
`created`	The date the folder was created. Shown in UNIX time.
`contentStatus`	Item content status. Organization members, as well as public members for verified organizations, can search for items that have these badges using the `contentStatus` filter. Authoritative items are automatically protected to prevent accidental deletion and are boosted in search results to increase visibility and encourage use. Example: Use dark colors for code blocksCopy `1 "contentStatus": "org_authoritative"`

JSON Response syntax

The syntax example below demonstrates the user content response returned at the user content root level:

Use dark colors for code blocksCopy
{
  "username": "<username>",
  "total": <total number of items owned by the user>,
  "start": <the first record index in the response>,
  "num": <the number of items in the response>,
  "nextStart": <the next entry index>,
  "currentFolder": root folder,
  "items": [
    {
      "id": "<item id>",
      "owner": "<owner username>",
      "created": date created shown in UNIX time,
      "modified": date modified shown in UNIX time,
      "guid": <unique id>,
      "name": "<item name>",
      "title": "<item title>",
      "type": "<type>",
      "typeKeywords": [
        "<keyword1>",
        "<keyword2>",
        "<keyword3>",
        "<keyword4>"
      ],
      "description": <description>,
      "tags": [
        "<tag1>",
        "<tag2>"
      ],
      "snippet": <summary>,
      "thumbnail": <file name>,
      "extent": [
        [
          <minX>,
          <minY>
        ],
        [
          <maxX>,
          <maxY>
        ]
      ],
      "spatialReference": <coordinate system>,
      "accessInformation": <credits>,
      "licenseInfo": <access and use constraints>,
      "culture": "<culture code>",
      "url": <url>,
      "access": "private | shared | org | public",
      "size": <item size>,
      "contentStatus": "<contentStatus>",
      "numComments": <number of comments>,
      "numRatings": <number of ratings>,
      "avgRating": <average rating>,
      "numViews": <number of views>
    },
    {
      "id": "<item id>",
      "owner": "<owner username>",
      "created": date created shown in UNIX time,
      "modified": date modified shown in UNIX time,
      "guid": <unique id>,
      "name": "<item name>",
      "title": "<item title>",
      "type": "<type>",
      "typeKeywords": [
        "<keyword1>",
        "<keyword2>",
        "<keyword3>",
        "<keyword4>"
      ],
      "description": <description>,
      "tags": [
        "<tag1>",
        "<tag2>"
      ],
      "snippet": <summary>,
      "thumbnail": <file name>,
      "extent": [
        [
          <minX>,
          <minY>
        ],
        [
          <maxX>,
          <maxY>
        ]
      ],
      "spatialReference": <coordinate system>,
      "accessInformation": <credits>,
      "licenseInfo": <access and use constraints>,
      "culture": "<culture code>",
      "url": <url>,
      "access": "private | shared | org | public",
      "size": <item size>,
      "contentStatus": "<contentStatus>",
      "numComments": <number of comments>,
      "numRatings": <number of ratings>,
      "avgRating": <average rating>,
      "numViews": <number of views>
    }
  ],
  "folders": [
    {
      "username": "<username>",
      "id": "<folder id>",
      "title": "<folder title>",
      "created": date created shown in UNIX time
    }
  ]
}

The syntax example below demonstrates the user content response returned at the user content folder level:

Use dark colors for code blocksCopy
{
  "username": "<username>",
  "currentFolder": {
    "username": "<username>",
    "id": "<folder id>",
    "title": "<folder title>",
    "created": date created shown in UNIX time
  },
  "items": [
    {
      "id": "<item id>",
      "owner": "<owner username>",
      "created": date created shown in UNIX time,
      "modified": date modified shown in UNIX time,
      "guid": <unique id>,
      "name": <item name>,
      "title": "<title>",
      "type": "<item type>",
      "typeKeywords": [
        "<keyword1>",
        "<keyword2>",
        "<keyword3>",
        "<keyword4>"
      ],
      "description": <description>,
      "tags": [
        "<tag1>",
        "<tag2>",
        "<tag3>",
        "<tag4>"
      ],
      "snippet": "<summary>",
      "thumbnail": "<file name>",
      "extent": [
        [
          <minX>,
          <minY>
        ],
        [
          <maxX>,
          <maxY>
        ]
      ],
      "spatialReference": <coordinate system>,
      "accessInformation": <credits>,
      "licenseInfo": <access and use constraints>,
      "culture": "<culture code>",
      "url": <url>,
      "access": "private | shared | org | public",
      "size": <item size>,
      "contentStatus": "<contentStatus>",
      "numComments": <number of comments>,
      "numRatings": <number of ratings>,
      "avgRating": <average rating>,
      "numViews": <number of views>
    }
  ]
}

JSON Response examples

The sample response below demonstrates user content response returned at the user content root level:

Use dark colors for code blocksCopy
{
  "username": "jsmith33",
  "total": 10,
  "start": 1,
  "num": 2,
  "nextStart": 3,
  "currentFolder": null,
  "items": [
    {
      "id": "1851c185888a43fcb3d6fffb78ae7c94",
      "owner": "jsmith33",
      "created": 1264091913000,
      "modified": 1256666605000,
      "guid": null,
      "name": "Usa_Prime_Imagery",
      "title": "Usa_Prime_Imagery",
      "type": "Layer",
      "typeKeywords": [
        "Data",
        "Layer",
        "ArcGlobe",
        "ArcGIS Explorer",
        "lyr"
      ],
      "description": "This detailed imagery map presents satellite imagery for the world and
       high-resolution (1m or better) imagery for the United States."
      "tags": [
        "layer",
        "imagery"
      ],
      "snippet": "Imagery of Southern California",
      "thumbnail": null,
      "extent": [],
      "spatialReference": null,
      "accessInformation": "Provided by Satellite Technologies",
      "licenseInfo": "This imagery is licensed to Satellite Technologies and non-commercial use is allowed."
      "culture": "en-us",
      "url": null,
      "access": "public",
      "size": 38912,
      "contentStatus": "org_authoritative",
      "numComments": 3,
      "numRatings": 7,
      "avgRating": 4,
      "numViews": 23
    },
    {
      "id": "28c343b688224d0ca1b5ba741c28de6e",
      "item": "National_Parks_in_California.lpk",
      "itemType": "file",
      "owner": "jsmith33",
      "created": 1263460602000,
	     "modified": 1256666605000,
      "guid": "1D70DAC0-505A-463F-A948-B324FD18BE2A",
      "name": "National_Parks_in_California",
      "title": "National Parks in California",
      "type": "Layer Package",
      "typeKeywords": [
        "Data",
        "Layer Package",
	       "ArcGlobe",
	       "ArcGIS Explorer",
	       "lpk"
	     ],
	     "description": "The National Parks are one of our greatest treasures.  Explore the Parks located in California.",
	     "tags": ["Parks, California"],
	     "snippet": "National Parks of California",
	     "thumbnail": "nationalparks.png",
	     "extent": [
	       [
	         -130.098,
	         15.469
	       ],
	       [
	         -63.337,
	         54.048
	       ]
	     ],
	     "spatialReference": "GCS_North_American_1983",
	     "accessInformation": "esri",
	     "licenseInfo": "Public use",
	     "culture": "en-us",
	     "url": null,
	     "access": "shared",
	     "size": 1402923,
      "contentStatus": "org_authoritative",
	     "numComments": 8,
	     "numRatings": 4,
	     "avgRating": 5,
	     "numViews": 17
	   }
	 ],
	 "folders": [
    {
	     "username": "jsmith33",
	     "id": "1a9ad803da604628b08c968ce602a231",
	     "title": "Street Maps",
	     "created": 1266354151000
	   }
  ]
}

The sample response below demonstrates user content response returned at the user content folder level:

Use dark colors for code blocksCopy
{
  "username": "jsmith33",
  "currentFolder": {
    "username": "jsmith33",
    "id": "1a9ad803da604628b08c968ce602a231",
    "title": "Street Maps",
    "created": 1266354151000
  },
  "items": [
    {
      "id": "0c92f2674fe5442bb9974dfc947bdd43",
      "owner": "jsmith33",
      "created": 1266354432000,
      "modified": 1256666605000,
      "guid": null,
      "name": null,
      "title": "City of Redlands",
      "type": "Web Map",
      "typeKeywords": [
        "Web Map",
        "Map",
        "Online Map",
        "ArcGIS Online"
      ],
      "description": null,
      "tags": [
        "Redlands",
        "Streets",
        "Transportation",
        "Highways"
      ],
      "snippet": "Street map of the city of Redlands, including major highways",
      "thumbnail": "thumbnail/ago_downloaded.png",
      "extent": [
        [
          -117.2609,
          34.0122
        ],
        [
          -117.1043,
          34.0983
        ]
      ],
      "spatialReference": null,
      "accessInformation": null,
      "licenseInfo": null,
      "culture": "en-us",
      "url": null,
      "access": "private",
      "size": 195,
      "contentStatus": "org_authoritative",
      "numComments": -1,
      "numRatings": -1,
      "avgRating": -1,
      "numViews": -1
    }
  ]
}