Batch Unshare Users, Applications or Groups
/sites/management/api/v1/components/{id}/members
Unshare one or more users, applications or groups that this component has been shared with. Member identifiers are specified using the memberId
query parameter; unsharing one or more users, applications or groups in a single request.
Introduced in release 19.4.1.
Authorization
To invoke this operation, the authenticated user or client application must have been shared with the resource and have one of the following sharing roles:
- Owner
- Manager
Batching
This operation supports batching of DELETE
requests. Two or more resource instances up to a maximum of 50 can be deleted in a single batch response by specifying a comma-separated list of resource identifiers using the memberId
query parameter. The response will contain details of each DELETE
response, providing the response status code, headers and response body.
Path Alternative Identifiers
The default identifier for a Component resource is the Component Identifier. The Component resource supports alternative identifiers.
nameComponent Name
Instead of the component identifier, the component name can be used to uniquely identify a component in the resource path. The default resource path parameter for a component is the component identifier, but when working with components the human-readable component name is sometimes easier.
http://api.example.com/sites/management/api/v1/components/name:FooterBar/members
Introduced in release 19.4.1.
Successful Response Examples
This operation responds with the following success (2xx) responses. For a full list of response HTTP status codes and example bodies, consult the Response section of this operation.
204No Content - Unshare a User and a Group
Remove user jsmith
and group marketing
from component MyComponent
.
Request
DELETE https://api.example.com/sites/management/api/v1/components/name:MyComponent/members?memberId=user:jsmith,group:marketing
204No Content - Unshare a Client Application
Remove client application MyProductAPPID
from theme MyComponent
.
Request
DELETE https://api.example.com/sites/management/api/v1/components/name:MyComponent/members?Introduced in release 20.3.3.memberId=user:MyProduct_APPID
204No Content - Unshare Multiple Groups
Remove groups engineering
and marketing
from component MyComponent
.
Request
DELETE https://api.example.com/sites/management/api/v1/components/name:MyComponent/members?memberId=group:engineering,group:marketing
204No Content - Unshare Multiple Users
Remove users jsmith1
and jsmith2
from component MyComponent
.
Request
DELETE https://api.example.com/sites/management/api/v1/components/name:MyComponent/members?memberId=user:jsmith1,user:jsmith2
Client Error Response Examples
This operation responds with following client error (4xx) responses with exception details in the response body. For a full list of response HTTP status codes and example bodies, consult the Response section of this operation.
404Not Found - Component Not Found
The site component does not exist or has been deleted, or the authenticated user or client application does not have access to the component.
Error Code
OCE-SITEMGMT-009045
Resolution - Check Identifier
Check that the component identifier is valid.
Resolution - Check Membership
Check that the authenticated user is a member of the component.
Exception Detail Fields
This error type includes the following fields/values in the response:
Field Name | Description |
component | Component that does not exist or is not visible to the authenticated user. |
For detailed information about this exception detail type, consult the ComponentNotFoundExceptionDetail schema in the definitions section of the swagger document.
Example Response Body
{ "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1", "title": "Component Not Found", "status": "404", "detail": "Component does not exist or has been deleted, or the authenticated user or client application does not have access to the component.", "o:errorCode": "OCE-SITEMGMT-009045", "component": { "id": "F40B9BE3E69F6DC440559A1F033BB2482DB740ECB2D8" } }
Introduced in release 19.4.1.
Request
-
id: string
Immutable identifier for the component.
-
memberId(optional): string
List of resource identifiers to use for a batched request. The syntax uses a comma-delimited sequence of resource identifiers.
Response
- application/json
204 Response
400 Response
401 Response
403 Response
404 Response
-
Cache-Control: string
Directives for caching mechanisms.
-
Content-Length: string
Size of the response body.
-
Content-Type: string
Content type of the response.
-
allOf
ComponentNotFoundExceptionDetail
Introduced in release 19.4.1.
-
object
ExceptionDetail
In addition to HTTP error code and error messages, it is often desirable to provide additional information to the client when a request fails. In such cases, the additional information will be included in the response body.
-
object
ComponentNotFoundExceptionDetail-allOf[1]
object
In addition to HTTP error code and error messages, it is often desirable to provide additional information to the client when a request fails. In such cases, the additional information will be included in the response body.
-
detail(optional):
string
Description specific to this occurrence of the problem. The human-readable, potentially multi-line details describing the problem in more details.
-
instance(optional):
string(uri)
URI to the link that provides more detail about the error.
-
o:errorCode(optional):
string
Application error code, which is different from HTTP error code. This code should be used to check for specific errors, rather than comparing fields such as the
title
ordetail
. -
o:errorDetails(optional):
array o:errorDetails
Multiple errors can be organized in a hierarchical structure.
-
o:errorPath(optional):
string
XPath or JSON path to indicate where the error occurs.
-
status(optional):
integer(int32)
Corresponding HTTP status code for the error.
-
title(optional):
string
Short, human-readable summary of the problem. It is not advisable to use the title as a way of checking for specific errors, use the
o:errorCode
for this purpose. -
type(optional):
string(uri)
Absolute URI that identifies the problem type. When this URI dereferenced, it should provide a human-readable summary of the problem, for example, as a HTML page.
object
-
component(optional):
string
Component that does not exist or is not visible to the authenticated user.
Introduced in release 19.4.1.
array
Multiple errors can be organized in a hierarchical structure.
-
object
ExceptionDetail
In addition to HTTP error code and error messages, it is often desirable to provide additional information to the client when a request fails. In such cases, the additional information will be included in the response body.
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
"title":"Component Not Found",
"status":"404",
"detail":"Component does not exist or has been deleted, or the authenticated user or client application does not have access to the component.",
"o:errorCode":"OCE-SITEMGMT-009045",
"component":{
"id":"F40B9BE3E69F6DC440559A1F033BB2482DB740ECB2D8"
}
}