Group Management

The Groups module allows organizing the user base into higher logical categories. Unlike Tags (simple labels), Groups are used for Mass Operation Management, facilitating the control of complex fleets and the extraction of consolidated reports.

---

Group Operations

Feature	Method	Path	Description
List Groups	GET	/groups	Lists the groupings with status filters.
Create Group	POST	/group	Creates a new operational grouping.

Example Response (List)

{
  "data": [
    {
      "id": 10,
      "name": "Logistics Drivers",
      "status": "active",
      "members": 42
    }
  ]
}

---

Linking and Relationships

A group can dynamically inherit members through Tags or direct links to Organizations.

POST /add-group

Field (Body)	Required	Description
group_id	Yes	Target group ID.
organization_id	Optional	Links all members of a B2B fleet.
tag_id	Optional	Links users who have a specific tag.

Request Body (Link Organization to Group)

{
  "group_id": 10,
  "organization_id": 5
}