Refresh Device Inventory
Forces a device to update its app inventory in SimpleMDM
Sends a remote command to a device to immediately update its app inventory. Useful when recently installed apps don't appear in SimpleMDM or when you need the most current app information.
Overview
This tool sends an MDM command to the device requesting an immediate inventory update. The device must be online and responsive to MDM commands. Inventory updates typically occur within a few minutes.
Setup
Use the same API key setup as other SimpleMDM tools:
- Navigate to Settings > API in SimpleMDM
- Create or use existing API key
- In Risotto, select Tools in the sidebar, then select SimpleMDM in the Tool groups list
- Find SimpleMDM Refresh Device Inventory, click Set up, and enter your key in Api Key
- Click Save
Usage
Refresh device inventory:
"Refresh SimpleMDM device inventory for device_id 12345"
Common workflow:
1. Find device: "Find SimpleMDM device for john@company.com"
2. Refresh inventory: "Refresh inventory for device 12345"
3. Wait 2-5 minutes
4. Get updated info: "Get device info for device 12345 with include_apps=true"
Configuration Options
Required:
device_id- Device ID from SimpleMDM Find User Device
How It Works
- Tool sends
UpdateInventoryMDM command to device via SimpleMDM API - SimpleMDM queues the command for delivery
- Device receives command when online
- Device collects current inventory (apps, profiles, certificates)
- Device reports updated inventory to SimpleMDM
- Updated data available via Get Device Information tool
Timeline:
- Command sent: Immediate
- Device receives: Within seconds to minutes (if online)
- Inventory collection: 1-2 minutes
- Data available: 2-5 minutes total
Response Format
Returns a success message:
Inventory refresh command sent successfully to device 12345.
The device will update its inventory within the next few minutes.
Use Get Device Information to see updated data.
Device Requirements
For successful refresh:
- Device must be online and connected to internet
- Device must be enrolled in SimpleMDM
- Device must be responsive to MDM commands
- Device must not be in lost mode or locked
Supported devices:
- macOS devices (all versions)
- iOS devices (all versions)
- iPadOS devices (all versions)
- tvOS devices (all versions)
Troubleshooting
Device not updating:
- Verify device is online and connected to internet
- Check device is enrolled (not removed or unenrolled)
- Ensure device is not in lost mode
- Wait 5-10 minutes (some devices take longer)
- Try sending command again
Command fails immediately:
- Verify device_id is correct
- Check API key permissions
- Confirm device exists in SimpleMDM
Partial inventory update:
- Some apps may not report immediately
- System apps may take longer to appear
- Try refreshing again after 10 minutes
When to Use
Good use cases:
- User just installed app, needs verification
- Troubleshooting missing apps in inventory
- Before checking for specific app installation
- After pushing apps (wait for installation, then refresh)
- Compliance checks requiring current data
Not necessary for:
- SimpleMDM automatically refreshes periodically (every 24 hours)
- If last inventory update was recent (check last_seen_at)
- When approximate data is sufficient
Rate Limiting
SimpleMDM may limit MDM command frequency:
- Avoid refreshing same device repeatedly
- Wait at least 5 minutes between refresh commands
- Consider whether automatic refresh is sufficient
Security Notes
- Requires API key with device management permissions
- MDM commands are authenticated and encrypted
- Inventory data includes installed apps and profiles
- No user interaction required on device
Related Tools
- SimpleMDM Find User Device - Get device_id to use with this tool
- SimpleMDM Get Device Information - View refreshed inventory data
- SimpleMDM Push Assigned Apps - Install apps before refreshing inventory
Something wrong or missing? Report an issue · View as Markdown