# Lytx.Group.Api

These routes are externally accessible and require authentication. All group routes require the authenticated user to have the Group Manager role.

Version: 1.0.0

## Servers

```
https://api.lytx.com/v1
```

## Security

### bearerAuth

Type: http
Scheme: bearer

## Download OpenAPI description

[Lytx.Group.Api](https://developer.lytx.com/_bundle/openapispec/group.openapi.yaml)

## Groups (DriveCam)

### Retrieve List of Groups

 - [GET /groups](https://developer.lytx.com/openapispec/group.openapi/groups-(drivecam)/paths/~1groups/get.md): Retrieve a list of groups in an organization.

### Add New Group to Organization

 - [POST /groups](https://developer.lytx.com/openapispec/group.openapi/groups-(drivecam)/paths/~1groups/post.md): Add a new group to the organization.

### Retrieve Specific Group

 - [GET /groups/{groupIdentifier}](https://developer.lytx.com/openapispec/group.openapi/groups-(drivecam)/paths/~1groups~1%7Bgroupidentifier%7D/get.md): Retrieve one group in the organization by group ID.

### Update Specific Group

 - [PUT /groups/{groupIdentifier}](https://developer.lytx.com/openapispec/group.openapi/groups-(drivecam)/paths/~1groups~1%7Bgroupidentifier%7D/put.md): Update one group in the organization by group ID.

### Delete Group

 - [DELETE /groups/{groupIdentifier}](https://developer.lytx.com/openapispec/group.openapi/groups-(drivecam)/paths/~1groups~1%7Bgroupidentifier%7D/delete.md): Delete a group in the organization.

Use with extreme caution. Deleting a group that has associated entities will result in orphaned entities, which cannot be recovered.

Ensure all entities are removed or moved before deleting the group to avoid data loss.

### Retrieve List of Descendant Group IDs

 - [GET /groups/{groupIdentifier}/descendants](https://developer.lytx.com/openapispec/group.openapi/groups-(drivecam)/paths/~1groups~1%7Bgroupidentifier%7D~1descendants/get.md): Retrieve a list of descendant group IDs for the specified group and depth.

### Retrieve List of Group Audit Logs

 - [GET /groups/auditLogs](https://developer.lytx.com/openapispec/group.openapi/groups-(drivecam)/paths/~1groups~1auditlogs/get.md): Retrieve a list of group audit logs in an organization.

### Bulk Import Groups

 - [POST /groups/bulkImport](https://developer.lytx.com/openapispec/group.openapi/groups-(drivecam)/paths/~1groups~1bulkimport/post.md): Bulk import groups into the organization.

### Bulk Move Groups

 - [POST /groups/bulkMove](https://developer.lytx.com/openapispec/group.openapi/groups-(drivecam)/paths/~1groups~1bulkmove/post.md): Bulk move groups in the organization.