Application Programming Interface Guide > Web Services Operations > Operations Reference > destroyGroup
 
destroyGroup
Destroy a group in a domain. The users within the group no longer belong to the destroyed group. If the group’s domain is an EXTERNAL domain, only the read-only reference to the group is deleted. The group still exists within that domain, but it is not visible to the TDV Server.
Location
/services/webservices/system/admin/user/operations/
Request Elements
domainName: The domain name.
groupName: The name of the group to destroy.
Request Example
<user:destroyGroup xmlns:user="http://www.compositesw.com/services/system/admin/user">
<user:domainName>composite</user:domainName>
<user:groupName>backup_admins</user:groupName>
</user:destroyGroup>
Response Elements
N/A
Faults
NotAllowed: If the group cannot be destroyed. For example, the “all” group in the composite domain cannot be destroyed.
NotAllowed: If an attempt is made to use this operation with an insufficient license.
NotFound: If the group does not exist.
NotFound: If the domain does not exist.
Security: If the user does not have the ACCESS_TOOLS and MODIFY_ALL_USERS rights.