- URL:https://[root]/content/users/[userName]/items/[itemID]/canReassign(POST only)
Example usage
The following is a sample ArcGIS Online POST request for the canReassign operation:
POST /webadaptor/sharing/rest/content/users/itemowner/items/b512083cd1b64e2da1d3f66dbb135956/canReassign HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
item=b512083cd1b64e2da1d3f66dbb135956&targetUsername=newOwner&f=pjson
The following is a sample ArcGIS Enterprise POST request for the canReassign operation:
POST /webadaptor/sharing/rest/content/users/itemowner/items/b512083cd1b64e2da1d3f66dbb135956/canReassign HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
item=b512083cd1b64e2da1d3f66dbb135956&targetUsername=newOwner&f=pjson
Description
The canReassign operation checks whether an item owned by one user can be successfully reassigned to a specified user before performing the reassignItem operation. Users assigned the default administrator role, or a custom role with administrative privileges, can perform this operation. The item owner can also use this operation; if the item owner that performs this operation is not a default administrator, or assigned a custom role with administrative privileges, they must have the portal:user:reassignItems privilege assigned to them to transfer content to another user.
Some item relationships (for example, a view created from another view instead of a primary layer) may block item reassignment. The conflicting item is listed in the error response.
Note:
If any item that is being reassigned have a private sharing level, the receiving member must have sharing access to all groups which those items are currently shared to.Request parameters
Parameter | Details |
---|---|
[Common Parameters] | For a complete listing, see Common parameters. |
targetUsername | The username of the user the item will be reassigned to. For a user to be eligible to receive transferred content, they must meet the following requirements:
If the above requirements are not met, an error response will be returned. Example
|
Response properties
Property | Details |
---|---|
success | Indicates if the operation was successful. |
itemId | The ID of the reassigned item. |
JSON Response syntax
The response syntax example below demonstrates an error response, returned when the user specified in the targetUsername parameter does not have the proper permissions to be reassigned an item:
{
"itemId": "<item id>",
"success": true | false,
"error": {
"code": <error code>,
"messageCode": "<error message code>",
"message": "<error message>",
"details": [
{
"itemId": "<item id>",
"type": "<item type>",
"url": "<url>",
"reservedTypeKeywords": [
"<reserved type keyword1>",
"<reserved type keyword2>"
],
"owner": "<owner>"
}
]
}
}
The response syntax example below demonstrates a success response:
{
"itemId": "<item id>",
"success": true | false
}
JSON Response example
The response example below demonstrates an error response, returned when the user specified in the targetUsername parameter does not have the proper permissions to be reassigned an item:
{
"itemId": "3fbb6f64dd3c41da8a5f9dd4be11a9fe",
"success": false,
"error": {
"code": 400,
"messageCode": "CONT_004821",
"message": "Unable to reassign item. This service item 'bb8e3d443ab44878ab8315b00b0612ca' has Views, that is related to other services",
"details": [
{
"itemId": "07efda2ec8934d0cab3b68018758701a",
"type": "Feature Service",
"url": "https://machine.domain.com/webadaptor/rest/services/FS123_View/FeatureServer",
"reservedTypeKeywords": [
"Hosted Service",
"View Service"
],
"owner": "FSowner"
}
]
}
}
The response example below demonstrates a success response:
{
"itemId": "<item id>",
"success": true | false
}