--- availability: INSTALLABLE description: A plugin that allows IT administrators to summarize orphaned devices that not currently assigned to any user in Jamf through the Moveworks AI Assistant. installation_asset_uuid: 174d60eb-f460-4e03-9f15-a5ae8ff48f15 name: Summarize Orphaned Devices purple_chat_link: https://marketplace.moveworks.com/purple-chat?conversation=%7B%22messages%22%3A%5B%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22I+need+to+look+up+orphaned+devices%22%7D%5D%7D%2C%7B%22role%22%3A%22assistant%22%2C%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22status%22%3A%22pending%22%2C%22richText%22%3A%22User+wants+to+find+orphaned+devices.+Clarifying+the+search+scope.%22%7D%5D%7D%2C%7B%22richText%22%3A%22Do+you+want+to+look+up%3A%3Col+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3E%3Cli%3Eall+orphaned+devices%3C%2Fli%3E%3Cli%3Eorphaned+devices+based+on+device+name+%28ex%3A+Macbook+Pro%29%3C%2Fli%3E%3C%2Fol%3E%22%7D%5D%7D%2C%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22I+want+to+view+orphaned+Macbook+air+devices%22%7D%5D%7D%2C%7B%22role%22%3A%22assistant%22%2C%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22status%22%3A%22success%22%2C%22richText%22%3A%22User+specified+%27Macbook+Air%27+devices.%22%7D%2C%7B%22status%22%3A%22pending%22%2C%22richText%22%3A%22Searching+%3Cb+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EJAMF%3C%2Fb%3E+for+orphaned+devices+matching+%27Macbook+Air%27.%22%7D%2C%7B%22status%22%3A%22success%22%2C%22richText%22%3A%22Found+5+matching+devices.%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EI+found+5+orphaned+MacBook+Air+devices.+Which+one+would+you+like+to+view%3F%3Cbr%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3EMacBook+Air+-+SN%3A+XYZ12345+%28Last+reported+date%3A+2023-10-25%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EMacBook+Air+-+SN%3A+ABC67890+%28Last+reported+date%3A+2023-11-01%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EMacBook+Air+-+SN%3A+DEF01234+%28Last+reported+date%3A+2023-09-15%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EMacBook+Air+-+SN%3A+GHI56789+%28Last+reported+date%3A+2024-01-05%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EMacBook+Air+-+SN%3A+JKL98765+%28Last+reported+date%3A+2023-12-10%29%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22connectorName%22%3A%22jamf%22%2C%22citationTitle%22%3A%22Orphaned+Device+Search+Results%22%7D%5D%7D%5D%7D%2C%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22I+want+to+see+details+for+MacBook+Air+-+SN%3A+XYZ12345%22%7D%5D%7D%2C%7B%22role%22%3A%22assistant%22%2C%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22status%22%3A%22success%22%2C%22richText%22%3A%22User+selected+device+%27MacBook+Air+-+SN%3A+XYZ12345%27.%22%7D%2C%7B%22status%22%3A%22pending%22%2C%22richText%22%3A%22Retrieving+detailed+information+for+MacBook+Air+-+SN%3A+XYZ12345+from+%3Cb+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EJAMF%3C%2Fb%3E.%22%7D%2C%7B%22status%22%3A%22success%22%2C%22richText%22%3A%22Successfully+retrieved+device+details.%22%7D%5D%7D%2C%7B%22richText%22%3A%22Here+are+the+details+for+%3Cb+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EMacBook+Air+-+SN%3A+XYZ12345%3C%2Fb%3E%3A%3Cbr+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22+%2F%3E%3Cul+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3E%3Cli%3E%3Cb%3EModel%3A%3C%2Fb%3E+MacBook+Air+%28M1%2C+2020%29%3C%2Fli%3E%3Cli%3E%3Cb%3ESerial+Number%3A%3C%2Fb%3E+XYZ12345%3C%2Fli%3E%3Cli%3E%3Cb%3ELast+Check-in%3A%3C%2Fb%3E+2023-10-25+14%3A30+UTC%3C%2Fli%3E%3Cli%3E%3Cb%3EStatus%3A%3C%2Fb%3E+Orphaned+%28No+user+assigned%2C+not+seen+in+90%2B+days%29%3C%2Fli%3E%3Cli%3E%3Cb%3EAssigned+User%3A%3C%2Fb%3E+None%3C%2Fli%3E%3Cli%3E%3Cb%3EDepartment%3A%3C%2Fb%3E+Unknown%3C%2Fli%3E%3Cli%3E%3Cb%3EJamf+Pro+ID%3A%3C%2Fb%3E+1234567%3C%2Fli%3E%3C%2Ful%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22connectorName%22%3A%22jamf%22%2C%22citationTitle%22%3A%22Device+Details+-+MacBook+Air+SN%3A+XYZ12345%22%7D%5D%7D%5D%7D%5D%7D solution_tags: - Access Management - IT systems: - jamf --- ## **Introduction** The **“Summarize Orphaned Devices”** plugin enables IT administrators to identify and summarize computer devices in Jamf Pro that are not currently assigned to any user. Through the Moveworks AI Assistant, the plugin provides a concise overview of orphaned assets — including the computer device name, model, OS version, and last check-in date — allowing IT teams to efficiently reclaim, reprovision, or clean up unused computer devices without manually searching in Jamf Pro. This guide will walk you through setting up and customizing the plugin in Agent Studio in just a few minutes. Let’s get started! ## **Prerequisites** • Access to **Agent Studio** ## **What are we building?** ### **Agent Design** This [purple chat](https://marketplace.moveworks.com/purple-chat?conversation=%7B%22messages%22%3A%5B%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22I+need+to+look+up+orphaned+devices%22%7D%5D%7D%2C%7B%22role%22%3A%22assistant%22%2C%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22status%22%3A%22pending%22%2C%22richText%22%3A%22User+wants+to+find+orphaned+devices.+Clarifying+the+search+scope.%22%7D%5D%7D%2C%7B%22richText%22%3A%22Do+you+want+to+look+up%3A%3Col+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3E%3Cli%3Eall+orphaned+devices%3C%2Fli%3E%3Cli%3Eorphaned+devices+based+on+device+name+%28ex%3A+Macbook+Pro%29%3C%2Fli%3E%3C%2Fol%3E%22%7D%5D%7D%2C%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22I+want+to+view+orphaned+Macbook+air+devices%22%7D%5D%7D%2C%7B%22role%22%3A%22assistant%22%2C%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22status%22%3A%22success%22%2C%22richText%22%3A%22User+specified+%27Macbook+Air%27+devices.%22%7D%2C%7B%22status%22%3A%22pending%22%2C%22richText%22%3A%22Searching+%3Cb+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EJAMF%3C%2Fb%3E+for+orphaned+devices+matching+%27Macbook+Air%27.%22%7D%2C%7B%22status%22%3A%22success%22%2C%22richText%22%3A%22Found+5+matching+devices.%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EI+found+5+orphaned+MacBook+Air+devices.+Which+one+would+you+like+to+view%3F%3Cbr%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3EMacBook+Air+-+SN%3A+XYZ12345+%28Last+reported+date%3A+2023-10-25%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EMacBook+Air+-+SN%3A+ABC67890+%28Last+reported+date%3A+2023-11-01%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EMacBook+Air+-+SN%3A+DEF01234+%28Last+reported+date%3A+2023-09-15%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EMacBook+Air+-+SN%3A+GHI56789+%28Last+reported+date%3A+2024-01-05%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EMacBook+Air+-+SN%3A+JKL98765+%28Last+reported+date%3A+2023-12-10%29%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22connectorName%22%3A%22jamf%22%2C%22citationTitle%22%3A%22Orphaned+Device+Search+Results%22%7D%5D%7D%5D%7D%2C%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22I+want+to+see+details+for+MacBook+Air+-+SN%3A+XYZ12345%22%7D%5D%7D%2C%7B%22role%22%3A%22assistant%22%2C%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22status%22%3A%22success%22%2C%22richText%22%3A%22User+selected+device+%27MacBook+Air+-+SN%3A+XYZ12345%27.%22%7D%2C%7B%22status%22%3A%22pending%22%2C%22richText%22%3A%22Retrieving+detailed+information+for+MacBook+Air+-+SN%3A+XYZ12345+from+%3Cb+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EJAMF%3C%2Fb%3E.%22%7D%2C%7B%22status%22%3A%22success%22%2C%22richText%22%3A%22Successfully+retrieved+device+details.%22%7D%5D%7D%2C%7B%22richText%22%3A%22Here+are+the+details+for+%3Cb+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EMacBook+Air+-+SN%3A+XYZ12345%3C%2Fb%3E%3A%3Cbr+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22+%2F%3E%3Cul+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3E%3Cli%3E%3Cb%3EModel%3A%3C%2Fb%3E+MacBook+Air+%28M1%2C+2020%29%3C%2Fli%3E%3Cli%3E%3Cb%3ESerial+Number%3A%3C%2Fb%3E+XYZ12345%3C%2Fli%3E%3Cli%3E%3Cb%3ELast+Check-in%3A%3C%2Fb%3E+2023-10-25+14%3A30+UTC%3C%2Fli%3E%3Cli%3E%3Cb%3EStatus%3A%3C%2Fb%3E+Orphaned+%28No+user+assigned%2C+not+seen+in+90%2B+days%29%3C%2Fli%3E%3Cli%3E%3Cb%3EAssigned+User%3A%3C%2Fb%3E+None%3C%2Fli%3E%3Cli%3E%3Cb%3EDepartment%3A%3C%2Fb%3E+Unknown%3C%2Fli%3E%3Cli%3E%3Cb%3EJamf+Pro+ID%3A%3C%2Fb%3E+1234567%3C%2Fli%3E%3C%2Ful%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22connectorName%22%3A%22jamf%22%2C%22citationTitle%22%3A%22Device+Details+-+MacBook+Air+SN%3A+XYZ12345%22%7D%5D%7D%5D%7D%5D%7D) shows the experience we are going to build. ## **Installation Steps** We recommend setting up **Jamf** **Connector** before installing this plugin. Please follow the [Jamf Connector](https://marketplace.moveworks.com/connectors/jamf?hist=home#how-to-implement) guide to configure the connection. **Note:** To enable access to Jamf Pro API endpoints, ensure that the appropriate privileges are assigned to the user via: **Settings → API Roles and Clients → API Roles → [API Role]**. **Required Privileges:** As an admin, ensure that the following **privileges are granted** to the API user to successfully install and use this plugin: - **Read Computers** This permission is required to retrieve user-related data and perform advanced searches within the Jamf Pro environment using the API. **Endpoint Guidelines:** - The **Jamf Pro `/mobile-devices` endpoint does not support filtering or partial search**. - Filtering using `filter=` parameters is supported **only for the `/computers-inventory` endpoint**. **Our Instance Configuration:** All Jamf Pro API endpoints in this plugin use **`YOUR_INSTANCE`** as a placeholder. After installation, replace **`YOUR_INSTANCE`** in the API calls with your actual Jamf instance name. To find your instance name: - Log into Jamf Pro. - Check the URL in your browser — the instance name appears before `.**jamfcloud.com**`, e.g.: **`https://YOUR_INSTANCE.jamfcloud.com/...`** Make sure to update this across all actions that reference the Jamf Pro API. Once the connector is successfully configured, follow our [**plugin installation documentation**](https://help.moveworks.com/docs/ai-agent-marketplace-installation) for detailed steps on how to install and activate the plugin in Agent Studio. ## **Appendix** ### **API #1: Search for Computers Based on Given Criteria** ```bash curl --location 'https:///api/v1/computers-inventory?section=USER_AND_LOCATION,HARDWARE,GENERAL&filter={{filter_query}}' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer ' ``` **Query Parameters** - `{{filter_query}}` – A **dynamic RSQL filter** constructed based on the user’s input or search context. - `{{device_name}}` – The partial or full name of the device to match against Jamf inventory records. - `{{device_id}}` – The unique identifier (ID) of the device in Jamf Pro used for an exact match. - `section` : Specifies the **broad data categories** to include in the response (for example: `GENERAL`, `HARDWARE`, `USER_AND_LOCATION`). **RSQL Filtering Notes:** - Use **RSQL syntax** in the `filter_query` parameter to filter on different objects/conditions. - Common examples: - All orphaned devices **-** `userAndLocation.username=='' or userAndLocation.username==null` - Partial search by device name **-** `general.name=='*{{device_name}}*'` - Orphaned devices by device ID - `(id=='{{device_id}}') and (userAndLocation.username=='' or userAndLocation.username==null)` **Note:** - This setup enables a **single API structure** to support both broad and targeted searches for orphaned devices — whether by username, device name, or a specific device record — improving flexibility and reducing redundant endpoint calls. - In JAMF, the username is mandatory for filtering; full name cannot be used.