list-computers

List Computers

List computers in ConnectWise Automate with optional filters for client, location, status, and OS type.

Prerequisites

• Valid ConnectWise Automate API credentials configured
• CONNECTWISE_AUTOMATE_SERVER environment variable set
• CONNECTWISE_AUTOMATE_USERNAME and CONNECTWISE_AUTOMATE_PASSWORD environment variables set

Steps

1. Build filter condition

   • Start with empty condition
   • Add client filter if specified
   • Add location filter if specified
   • Add status filter if specified
   • Add OS filter if specified

2. Construct API request

   GET /cwa/api/v1/Computers?condition={encoded_condition}&pageSize={limit}
   Authorization: Bearer {token}
   

3. Build filter examples

   // Client filter
   if (client) {
     conditions.push(`Client.Name contains '${client}'`);
   }
   
   // Status filter
   if (status === 'online') {
     conditions.push("Status = 'Online'");
   } else if (status === 'offline') {
     conditions.push("Status = 'Offline'");
   }
   
   // OS filter
   if (os === 'server') {
     conditions.push("OS contains 'Server'");
   } else if (os === 'workstation') {
     conditions.push("OS contains 'Windows' and not (OS contains 'Server')");
   }
   
   const condition = conditions.join(' and ');
   

4. Execute request with pagination

   • Use pageSize from limit or default 50
   • Handle pagination if more results exist

5. Format and return results

   • Computer name
   • Client name
   • Location
   • Status
   • IP address
   • OS
   • Last contact

Parameters