# 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

## 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

Source: https://www.tryrisotto.com/docs/integrations/tools/simplemdm/refresh_device_inventory
