Docs

Integrations / Devices / SimpleMDM

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:

  1. Navigate to Settings > API in SimpleMDM
  2. Create or use existing API key
  3. In Risotto, select Tools in the sidebar, then select SimpleMDM in the Tool groups list
  4. Find SimpleMDM Refresh Device Inventory, click Set up, and enter your key in Api Key
  5. 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

  1. Tool sends UpdateInventory MDM command to device via SimpleMDM API
  2. SimpleMDM queues the command for delivery
  3. Device receives command when online
  4. Device collects current inventory (apps, profiles, certificates)
  5. Device reports updated inventory to SimpleMDM
  6. 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
  • 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