19 endpoints

# Users & Access

User accounts, roles, user groups, and RBAC permissions.

## Users

POST`/employees/{uuid}/user`Create User AccountCreate a login account for an employee. Optionally auto-generates a temporary password. The user will be required to change their password on first login.

GET`/users`List UsersGet all user accounts for the company.

GET`/users/{uuid}`Get UserGet a specific user account by UUID.

PUT`/users/{uuid}`Update UserUpdate a user account (e.g. email, active status).

DELETE`/users/{uuid}`Delete UserSoft-delete a user account (revokes login access, does not delete employee record).

POST`/users/{uuid}/password-reset`Admin Password ResetGenerate a new temporary password for a user and optionally send it by email.

GET`/users/{uuid}/access`Get User AccessGet all permissions for a user (resolved from groups + individual overrides).

PUT`/users/{uuid}/access`Update User Individual AccessSet individual permission overrides for a user. These override group permissions.

GET`/users/{uuid}/groups`Get User GroupsGet the groups a user belongs to.

PUT`/users/{uuid}/groups`Update User GroupsSet the groups a user belongs to. Replaces existing group membership.

## Groups

GET`/groups`List GroupsGet all user groups for the company.

POST`/groups`Create GroupCreate a custom access group.

PUT`/groups/{uuid}`Update GroupUpdate a group name or description.

DELETE`/groups/{uuid}`Delete GroupDelete a custom group. Cannot delete system groups (Staff Member, Manager, HR Manager, Company Admin).

GET`/groups/{uuid}/access`Get Group PermissionsGet all permissions assigned to a group.

PUT`/groups/{uuid}/access`Update Group PermissionsSet permissions for a group. Replaces all existing group permissions.

GET`/groups/{uuid}/members`Get Group MembersGet all users in a group.

PUT`/groups/{uuid}/members`Update Group MembersSet the members of a group. Replaces existing membership.

## Access Permissions

GET`/access`List All Access PermissionsGet the complete list of all available access permission keys in the system.

---

**URL:** https://cube-hr.co.uk/docs/users