Device Groups

Organize devices into groups.

List Groups

GET/v1/fleet/groups

Response

{
  "groups": [
    {
      "id": "grp_abc123",
      "name": "Warehouse A",
      "description": "Main warehouse robots",
      "device_count": 5,
      "created_at": "2025-01-01T00:00:00Z"
    }
  ],
  "total": 3
}

Create Group

POST/v1/fleet/groups

Request

{
  "name": "Production Line 1",
  "description": "Assembly line robots"
}

Response

{
  "success": true,
  "group": {
    "id": "grp_xyz789",
    "name": "Production Line 1",
    "description": "Assembly line robots"
  }
}

Assign Devices

POST/v1/fleet/groups/{group_id}/assign

Request

{
  "device_ids": ["robot-alpha-01", "robot-alpha-02"]
}

Unassign Devices

POST/v1/fleet/groups/{group_id}/unassign

Delete Group

DELETE/v1/fleet/groups/{group_id}

Response

{
  "success": true,
  "group_id": "grp_abc123",
  "devices_unassigned": 5
}

Examples

Python SDK

# Create group
result = client.fleet.create_group(
    name="Warehouse A",
    description="Main warehouse robots"
)

# Assign devices
client.fleet.assign_devices(
    result.group.id,
    ["robot-001", "robot-002"]
)

# List groups
groups = client.fleet.list_groups()
for group in groups.groups:
    print(f"{group.name}: {group.device_count} devices")