/canReassign: Can Reassign Item

URL:
https://[root]/content/users/[userName]/items/[itemID]/canReassign
Methods:
POST

Example usage

The following is a sample ArcGIS Online POST request for the canReassign operation:

1
2
3
4
5
6
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:

1
2
3
4
5
6
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.

Request parameters

ParameterDetails

[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:

  • The user must be assigned the portal:user:receiveItems privilege to receive the transferred content.
  • The user must have a user type that allows them to own content. To learn more about user types, see the User types, roles, and privileges topic.
  • If the item being transferred to the user is shared with a group, the user receiving the item must be a member of the group. If the group is a view-only group, the user receiving the item must be the group owner or a group manager.

If the above requirements are not met, an error response will be returned.

Example:

1
targetUsername=newOwner

Response properties

PropertyDetails

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:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "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:

1
2
3
4
{
  "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:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "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:

1
2
3
4
{
  "itemId": "<item id>",
  "success": true | false
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close