How to Retrieve Windows Autopilot Info via Softnet API

Overview

 This article explains how to retrieve Windows Autopilot information for a Softdrive machine using the Softnet API. 

 The process involves initiating a request, tracking its execution, and retrieving the resulting data once the action completes. 

Applies To

  • Softnet API
  • Softdrive Virtual Machines
  • Administrators retrieving Autopilot device information

Prerequisites

  • Access to Softnet API endpoints
  • Valid authentication (API token or session)
  • Computer ID of the target device

Procedure

  1. Access the Softnet API Documentation
    • Open a browser and go to:
      https://softnet.softdrive.co
    •  Log in with your Softdrive credentials 
    •  Navigate to Help → API Documentation 
  2. Retrieve the Computer ID
    • Call the Get computers endpoint
    • Locate the id field for the desired machine
  3. Request Autopilot Information
    • Call the Get Windows Autopilot info endpoint
    • Provide the Computer ID in the request
    • Copy the returned computerAction ID from the response
  4. Check Action Status
    • Call the Get computer action endpoint
    • Use the computerAction ID obtained previously
    • Wait until the status changes to success
  5. Retrieve Autopilot Data
    • Once successful, review the statusDetails field
    • The data will be returned in JSON format
    • Extract the following information:
      • Hardware Hash
      • Windows Product ID
      • Device Serial Number

Expected Result

 The Autopilot information is successfully retrieved and displayed in JSON format, including hardware hash, product ID, and serial number. 

Troubleshooting

  • Ensure the Computer ID is correct
  • Verify API authentication is valid
  • Allow a few seconds for the action to complete before checking status
  • If status does not change to success, retry the request
  • If issues persist, contact support@softdrive.co