- URL:
- https://[root]/content/users/[userName]/items/[itemID]
- Methods:
GET
- Operations:
- Add Resources, Add Resources, Can Delete Item, Can Recycle Item, Delete, Delete Info, Move, Protect, Reassign, Remove Resources, Share, Unprotect, Unshare, Update, Update Info, Update Resources, Update Thumbnail
- Child Resources:
- Resources
Example usage
The following is a sample ArcGIS Online request URL used to access the user item resource:
https://org.arcgis.com/sharing/rest/content/users/jsmith/items/1851c185888a43fcb3d6fffb78ae7c94?f=pjson
The following is a sample ArcGIS Enterprise request URL used to access the user item resource:
https://machine.domain.com/webadaptor/sharing/rest/content/users/jsmith/items/1851c185888a43fcb3d6fffb78ae7c94?f=pjson
Description
An individual user-uploaded item link resource returns alist of groups with which the item is shared. The item is not physically stored in the user's folder but is stored as a link to the original item in the item resource (/content/items/[item
). Access to the item via this link is available only to the user.
Request parameters
Parameter | Details |
---|---|
| For a complete listing, see Common parameters. |
| Returns an item from the recycle bin. The default is Values: Example:
An error is returned, if the value is set to Error message
|
Response properties
Property | Details |
---|---|
| The unique ID for this item. |
| The username of the user who owns this item. |
| The date the item was created. Shown in UNIX time in milliseconds. |
| The date the item was last modified. Shown in UNIX time in milliseconds. |
| The file name of the item for file types. Read-only. |
| The title of the item. This is the name that's displayed to users and by which they refer to the item. Every item must have a title. |
| The URL for the resource represented by the item. Applies only to items that represent web-accessible resources such as map services. |
| The GIS content type of this item. Example types include Web Map, Map Service, Shapefile, and Web Mapping Application. See the overview section of Items and item types to get an understanding of the item type hierarchy. |
| An array of keywords that further describes the type of this item. Each item is tagged with a set of type keywords that are derived based on its primary type. |
| Item description. |
| An array of user defined tags that describe the item. |
| A short summary description of the item. |
| The URL to the thumbnail used for the item. |
| An array that defines the bounding rectangle of the item. Should always be in WGS84. Example:
|
| An array of organization categories that are set on the item. Example:
|
| The coordinate system of the item. |
| Information on the source of the item and its copyright status. |
| Any license information or restrictions. |
| The item locale information (language and country). |
| Indicates the level of access to the item. Values: |
| A JSON object used to restrict service item response results based on specified filter, i.e. limit results returned from a geocode service based on defined filters. See serviceProxyFilter for object details. |
| A JSON object that primarily applies to system requirements, Terms and Conditions, version, supported platforms, YouTube video ID, etc associated with the application. If the item is of type notebook, you can specify the runtime version of the notebook. Notebook example:
|
| An array that primarily applies to a list of categories that the application item is applicable to. |
| An array that primarily applies to industries associated with the application. |
| An array that primarily applies to languages associated with the application. |
| Primarily applies to thumbnails associated with an application. The URL to the thumbnail used for the application. |
| Primarily applies to the banner associated with an application. The URL to the banner used for the application. |
| An array that primarily applies to screenshots associated with an application. The URL to the screenshots used for the application. |
| If |
| The ID of the folder in which the owner has stored the item. The property is only returned to the item owner or the org admin. |
| The size of the item in bytes. |
| Protects the item from deletion. |
| Number of comments on the item. |
| Number of ratings on the item. |
| Average rating. Uses a weighted average called "Bayesian average." |
| Number of views of the item. |
(Optional) | Indicates user's control to the item. Values: |
| Item content status. Organization members, as well as public members for verified organizations, can search for items that have these badges using the Example:
|
| Item information completeness score based upon item snippet, thumbnail, description, title, tags etc. |
| Any special groups the item may belong to. Example:
|
| A JSON object with two properties Example:
|
| Epoch in milliseconds. Can be set for the registered app item. Used as expiration date when generating an API Token1. Example:
|
| Epoch in milliseconds. Can be set for the registered app item. Used as expiration date when generating an API Token2. Example:
|
| The date/time the item was last accessed in UNIX format (in milliseconds). Example:
|
| Introduced at ArcGIS Enterprise 11.4. The classification marking for an item, denoting its access restrictions and any dissemination information. The classification information returned as part of the Example:
|
JSON Response syntax
{
"item": {
"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>",
"classification": {
"attributeKey": "<attributeValue>",
"bannerText": "<classification label information>",
"createdUser": "<username of member who classified the item>",
"createdDate": <date classified in UNIX time>,
"lastEditedUser": "<username of member who last updated the item's classification>",
"lastEditedDate": <date classification updated in UNIX time>,
"attributeKey": "<attributeValue>",
"attributeKey": "<attributeValue>",
...
},
"licenseInfo": "<access and use constraints>",
"culture": <culture code>,
"url": <url>
"access": "private | public | org | shared",
"size": <size>,
"contentStatus": "<contentStatus>",
"numComments": <number of comments>,
"numRatings": <number of ratings>,
"avgRating": <average rating>,
"numViews": <number of views>,
"itemControl": "admin | update",
"scoreCompleteness": <score>,
"groupDesignations": <special groups list>,
"apiToken1ExpirationDate": <Epoch in milliseconds>,
"apiToken2ExpirationDate": <Epoch in milliseconds>,
"lastViewed": <date/time in UNIX format>
},
"sharing": {
"access": "private | public | org | shared",
"groups": [<group id1>, <group id2>...]
}
}
JSON Response example
{
"id": "10ba62fe50864339a8a3e0f18ca85506",
"owner": "jsmith",
"created": 1263404798000,
"modified": 1256666605000,
"name": null,
"title": "Highland Earthquake",
"type": "Web Map",
"typeKeywords": [
"Web Map",
"Map",
"Online Map",
"ArcGIS Online"
],
"description": "This web map shows recent earthquakes in Southern California, specifically the city of Highland. The web map presents a live map service from the USGS displayed over pre-earthquake imagery of the area.",
"tags": [
"Highland"
"Southern California",
"earthquake",
"earthquakes",
"quake"
],
"snippet": "This web map shows recent earthquakes around Southern California. The web map features a live map service from the USGS NHSS displayed over pre-earthquake imagery of the area.",
"thumbnail": "thumbnail/earthquake.jpg",
"extent": [
[
-117.81,
34.39
],
[
-116.56,
33.72
]
],
"spatialReference": null,
"categories": [
"/Categories/Hydrography/River",
"/Categories/Protected sites"
],
"accessInformation": null,
"classification": {
"classification": "In-confidence",
"banner": "In-confidence//Legal Privilege/To be reviewed on 2025-05-05",
"distribution": "Legal Privilege",
"reviewDate": "2025-05-05",
"lastEditedUser": "admin",
"lastEditedDate": 1726801728316,
"createdUser": "admin",
"createdDate": 1726801728316
},
"licenseInfo": "Please see: https://nhss.cr.usgs.gov/data.shtml and https://nhss.cr.usgs.gov/disclaim.shtml",
"culture": "en-us",
"url": null,
"proxyFilter": null,
"access": "org",
"size": 612,
"properties": null,
"appCategories": [],
"industries": [],
"languages": [],
"largeThumbnail": null,
"banner": null,
"screenshots": [],
"listed": false,
"ownerFolder": "12599675ae0c487ebe31defb86b0173e",
"protected": true,
"commentsEnabled": false,
"numComments": 14,
"numRatings": 21,
"avgRating": 5,
"numViews": 65,
"itemControl": "admin",
"contentStatus": "org_authoritative",
"scoreCompleteness": 60,
"groupDesignations": "livingatlas",
"apiToken1ExpirationDate": 1707943987000,
"apiToken2ExpirationDate": 1708203187000,
"lastViewed": 1613148239000
}