# Unit Access Groups

Represents Unit Access Groups within the Property Management System (PMS), allowing access control and permission management for unit entities. Unit Access Groups link units to Access Groups which are the access control groups defined in external acces control systems. Contacts are linked to Access Groups for the duration of their stay based on unit they are staying in

## Retrieve list of Unit Access Groups

 - [GET /api/v3/unitAccessGroups](https://apidocs.resharmonics.com/apis/resharmonics-pms/unit-access-groups/listallunitaccessgroups.md): Fetch a list of all unit access groups within the Property Management System (PMS). This endpoint is useful for retrieving detailed information about unit access groups, including their associated units and access group names. The response includes a paginated list of unit access groups, which can be used for managing access control and permissions. If no unit access groups are found, an empty list will be returned. In case of an unexpected system error, a  will be triggered.

## Update a unit access group

 - [PUT /api/v3/unitAccessGroups](https://apidocs.resharmonics.com/apis/resharmonics-pms/unit-access-groups/updateunitaccessgroup.md): Update an existing unit access group within the Property Management System (PMS). This endpoint allows the modification of details for a specific unit access group, including its associated unit and access group information. The request body must include the updated details of the unit access group. The response includes the updated unit access group details. If the specified unit access group ID does not exist, a  error will be returned. In case of validation errors, a  error will be returned. In case of an unexpected system error, a  will be triggered.

## Create a new Access Group

 - [POST /api/v3/unitAccessGroups](https://apidocs.resharmonics.com/apis/resharmonics-pms/unit-access-groups/createunitaccessgroup.md): Create a new unit access group within the Property Management System (PMS). This endpoint allows the creation of a new unit access group, which links a unit to an access group. The request body must include details of the unit and the access group. The response includes the newly created unit access group details. In case of validation errors, a  error will be returned. In case of an unexpected system error, a  will be triggered.

## Retrieve an Unit Access Group by Id

 - [GET /api/v3/unitAccessGroups/{id}](https://apidocs.resharmonics.com/apis/resharmonics-pms/unit-access-groups/getunitaccessgroupbyid.md): Fetch detailed information about a specific unit access group within the Property Management System (PMS) using its unique ID. Unit access groups are essential for managing access control and permissions for unit entities. This endpoint is useful for retrieving unit access group-specific data for reporting, auditing, and data management purposes. The response includes details about the unit access group, including its associated unit and access group names. If the specified unit access group ID does not exist, a  error will be returned. In case of an unexpected system error, a  will be triggered.