- URL:https://[root]/portals/[portalID]/assignMemberCategorySchema(POST only)
Example usage
The following is a sample ArcGIS Online POST request for the assignMemberCategorySchema operation:
POST /sharing/rest/portals/0123456789ABCDEF/assignMemberCategorySchema HTTP/1.1
Host: org.arcgis.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
memberCategorySchema={
"memberCategorySchema": [
{
"title": "Office Location",
"categories": [
{
"title": "USA",
"categories": [
{
"title": "Maine"
},
{
"title": "California",
"categories": [
{
"title": "Redlands"
},
{
"title": "San Diego"
}
]
}
]
},
{
"title": "Europe",
"categories": [
{
"title": "Zurich"
},
{
"title": "Edinburgh"
}
]
}
]
},
{
"title": "Department",
"categories": [
{
"title": "Sales"
},
{
"title": "Consulting"
}
]
}
]
}&f=pjsonThe following is a sample ArcGIS Enterprise POST request for the assignMemberCategorySchema operation:
POST /webadaptor/sharing/rest/portals/0123456789ABCDEF/assignMemberCategorySchema HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
memberCategorySchema={
"memberCategorySchema": [
{
"title": "Office Location",
"categories": [
{
"title": "USA",
"categories": [
{
"title": "Maine"
},
{
"title": "California",
"categories": [
{
"title": "Redlands"
},
{
"title": "San Diego"
}
]
}
]
},
{
"title": "Europe",
"categories": [
{
"title": "Zurich"
},
{
"title": "Edinburgh"
}
]
}
]
},
{
"title": "Department",
"categories": [
{
"title": "Sales"
},
{
"title": "Consulting"
}
]
}
]
}&f=pjsonDescription
The assignMemberCategorySchema operation allows organization administrators and members with appropriate privileges to categorize organization members. Once the administrator or member with appropriate privileges sets up member categories in their organization, they can assign the categories to the members. They can then filter the members based on the categories.
An organization can have up to three levels of categories in the hierarchy, with a maximum of 200 categories and subcategories. Each organization member can have a maximum of 20 member categories assigned to them. It is recommended that you create a comprehensive and complete category hierarchy and naming scheme is before assigning categories to members.
The operation is available to both Esri default administrators and custom roles with the portal:admin:updateUsers privilege.
Request parameters
| Parameter | Details |
|---|---|
| memberCategorySchema | A memberCategorySchema object that consists of an array of JSON objects representing top level categories. Each object can include the title, description, and categories properties. The categories property consists of an array of objects with each object having the same properties and represents the descendant categories or subcategories. Note:The forward slash (/) and comma (,) characters are reserved and cannot be used as values for the title property. Example, formatted for readability |
| f | The response format. The default format is html. Values: html | json | pjson |
Response properties
| Property | Details |
|---|---|
| success | Indicates whether the operation was successful. |
JSON Response syntax
{
"success": true
}JSON Response example
The following is a sample success response for the assignMemberCategorySchema operation:
{
"success": true
}The following is a sample error message for the assignMemberCategorySchema operation:
{
"error": {
"code": 400,
"messageCode": "ORG_1132",
"message": "Unable to assign member category schema.",
"details": ["Member category schema exceeds max tree size or empty."]
}
}