--- availability: INSTALLABLE description: A plugin that allows users to look up their inventory information in Jamf. installation_asset_uuid: 1deb8830-08e3-4442-be59-e83a3d7e50bc name: Inventory Look Up purple_chat_link: https://marketplace.moveworks.com/purple-chat?conversation=%7B%22messages%22%3A%5B%7B%22parts%22%3A%5B%7B%22richText%22%3A%22Where+can+I+see+the+full+details+for+my+company+laptop%3F%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22richText%22%3A%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3ESearching+for+devices+assigned+to+you+in+%3Cb%3EJamf%3C%2Fb%3E%3C%2Fp%3E%22%2C%22status%22%3A%22success%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EI+found+these+devices+assigned+to+you+in+Jamf.+Please+select+the+one+you+want+to+view+by+replying+with+the+number.%3C%2Fp%3E%3Col+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3E%3Cli%3EMacBook+Pro+%28Serial%3A+C02XXXXXX%29%3C%2Fli%3E%3Cli%3EiPhone+15+Pro+%28Serial%3A+F4GXXXXXX%29%3C%2Fli%3E%3C%2Fol%3E%22%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%221%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22richText%22%3A%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3ERetrieving+inventory+report+for+MacBook+Pro+%28Serial%3A+C02XXXXXX%29+from+%3Cb%3EJamf%3C%2Fb%3E%3C%2Fp%3E%22%2C%22status%22%3A%22success%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EHere+is+the+comprehensive+inventory+report+for+your+MacBook+Pro%2C+Serial+%3Cstrong%3EC02XXXXXX%3C%2Fstrong%3E%3A%3Cbr%3E%3C%2Fp%3E%3Cp%3E%3Cstrong%3EDevice+Identification%3C%2Fstrong%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3EDevice+Name%3A+jsmith-macbook-pro%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ESerial+Number%3A+C02XXXXXX%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EAsset+Tag%3A+2025-01138%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%3Cp%3E%3Cstrong%3EStatus%3C%2Fstrong%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3ELast+Check-in%3A+August+19%2C+2025%2C+10%3A50+AM+IST%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EManaged%3A+Yes%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EEncryption%3A+FileVault+Enabled%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%3Cp%3E%3Cstrong%3EPurchasing+and+Warranty%3C%2Fstrong%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3EWarranty+Expires%3A+October+25%2C+2026%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EAppleCare+ID%3A+AC123456789%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%3Cp%3E%3Cstrong%3ESoftware+and+Policy+Management%3C%2Fstrong%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3EComputer+Groups%3A+All+Staff%2C+US+Employees%2C+Marketing+Dept%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ESoftware+Installed+by+Jamf%3A+Microsoft+Office%2C+Adobe+Acrobat%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EAvailable+macOS+Updates%3A+macOS+14.6+Security+Update%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%3Cp%3E%3Cstrong%3EHardware+and+Operating+System%3C%2Fstrong%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3EModel%3A+MacBook+Pro+%2816-inch%2C+M3%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EOperating+System%3A+macOS+14.5%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ERAM%3A+16+GB%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%3Cp%3E%3Cstrong%3ENetwork%3C%2Fstrong%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3EIP+Address%3A+192.168.1.105%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EMAC+Address%3A+6A%3A2C%3A4B%3AB7%3A65%3AC8%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22citationTitle%22%3A%22MacBook+Pro+C02XXXXXX%22%2C%22connectorName%22%3A%22jamf%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%5D%7D solution_tags: - IT systems: - jamf --- ## **Introduction** The **“Inventory Look Up”** plugin enables users to quickly view detailed information about devices assigned to individuals within the Jamf Pro environment. It allows for efficient inventory searches by username, making it easy to locate the necessary devices. This guide will walk you through installing and configuring 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%22parts%22%3A%5B%7B%22richText%22%3A%22Where+can+I+see+the+full+details+for+my+company+laptop%3F%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22richText%22%3A%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3ESearching+for+devices+assigned+to+you+in+%3Cb%3EJamf%3C%2Fb%3E%3C%2Fp%3E%22%2C%22status%22%3A%22success%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EI+found+these+devices+assigned+to+you+in+Jamf.+Please+select+the+one+you+want+to+view+by+replying+with+the+number.%3C%2Fp%3E%3Col+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3E%3Cli%3EMacBook+Pro+%28Serial%3A+C02XXXXXX%29%3C%2Fli%3E%3Cli%3EiPhone+15+Pro+%28Serial%3A+F4GXXXXXX%29%3C%2Fli%3E%3C%2Fol%3E%22%7D%5D%2C%22role%22%3A%22assistant%22%7D%2C%7B%22parts%22%3A%5B%7B%22richText%22%3A%221%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22richText%22%3A%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3ERetrieving+inventory+report+for+MacBook+Pro+%28Serial%3A+C02XXXXXX%29+from+%3Cb%3EJamf%3C%2Fb%3E%3C%2Fp%3E%22%2C%22status%22%3A%22success%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EHere+is+the+comprehensive+inventory+report+for+your+MacBook+Pro%2C+Serial+%3Cstrong%3EC02XXXXXX%3C%2Fstrong%3E%3A%3Cbr%3E%3C%2Fp%3E%3Cp%3E%3Cstrong%3EDevice+Identification%3C%2Fstrong%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3EDevice+Name%3A+jsmith-macbook-pro%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ESerial+Number%3A+C02XXXXXX%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EAsset+Tag%3A+2025-01138%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%3Cp%3E%3Cstrong%3EStatus%3C%2Fstrong%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3ELast+Check-in%3A+August+19%2C+2025%2C+10%3A50+AM+IST%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EManaged%3A+Yes%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EEncryption%3A+FileVault+Enabled%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%3Cp%3E%3Cstrong%3EPurchasing+and+Warranty%3C%2Fstrong%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3EWarranty+Expires%3A+October+25%2C+2026%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EAppleCare+ID%3A+AC123456789%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%3Cp%3E%3Cstrong%3ESoftware+and+Policy+Management%3C%2Fstrong%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3EComputer+Groups%3A+All+Staff%2C+US+Employees%2C+Marketing+Dept%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ESoftware+Installed+by+Jamf%3A+Microsoft+Office%2C+Adobe+Acrobat%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EAvailable+macOS+Updates%3A+macOS+14.6+Security+Update%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%3Cp%3E%3Cstrong%3EHardware+and+Operating+System%3C%2Fstrong%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3EModel%3A+MacBook+Pro+%2816-inch%2C+M3%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EOperating+System%3A+macOS+14.5%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ERAM%3A+16+GB%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%3Cp%3E%3Cstrong%3ENetwork%3C%2Fstrong%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3EIP+Address%3A+192.168.1.105%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EMAC+Address%3A+6A%3A2C%3A4B%3AB7%3A65%3AC8%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22citationTitle%22%3A%22MacBook+Pro+C02XXXXXX%22%2C%22connectorName%22%3A%22jamf%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%5D%7D) shows the experience we are going to build. ## **Installation Steps** We recommend setting up Jamf 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 following API roles are assigned to the API Client **Settings → API Roles and Clients → API Roles → [Your API Role]**. Specifically, confirm that the following privilege is granted: - **Read User** - **Read Computers** - **Read Mobile Devices** This permission is required to retrieve user-related data and perform advanced searches within the Jamf Pro environment using the 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. **Note:** This plugin identifies users by their email address to determine the username. Depending on your company's policy, you may need to adjust this configuration. ## **Appendix** ### **API #1: Get Username By Email** ```bash curl --location 'https:///JSSResource/users/email/{{user_email}}' \ --header 'authorization: Bearer ' \ --header 'accept: application/json' \ ``` **Path Parameters:** - `user_email` (string) – Returns the details assigned to the specific users. ### **API #2: Get All Users Devices via Name** ```bash curl --location 'https:///JSSResource/users/name/{{user_name}}' \ --header 'authorization: Bearer ' \ --header 'accept: application/json' \ ``` **Path Parameters:** - `user_name`(string) – Returns the details of the user, including linked devices such as computer and mobile devices. ### **API #3: Look Up Inventory Details** ```bash curl --location 'https:///JSSResource/{{device_type}}/id/{{inventory_id}}' \ --header 'Authorization: Bearer ' \ --header 'Accept: application/json' \ ``` **Path Parameters:** - **device_type** (string) – The type of device to query. Accepted values are: `computers`, `mobiledevices` - **inventory_id** (integer) – The unique ID of the device whose inventory details you want to retrieve.