---
updatedAt: 2025-09-15T01:44:10.000Z
agentTools:
  siteIndex: https://developer.jamf.com/llms.txt
  projectIndex: https://developer.jamf.com/jamf-pro/v11.14.0/llms.txt
---

# Creates a new mobile device command

The chart below includes additional requirements for usage of specific commands

| command | Parameters | Requirements | Values |
| ---------- | ------- | ------------ | ------ |
| DeviceLocation | N/A | Supervised and in lost mode | N/A |
| DisableLostMode | N/A | Supervised and in lost mode | N/A |
| EnableLostMode | lost_mode_message | Supervised device (required if lost_mode_phone is not set) | string |
| EnableLostMode | lost_mode_phone | Supervised device (required if lost_mode_message is not set) | string |
| EnableLostMode | lost_mode_footnote | optional | string |
| EnableLostMode | always_enforce_lost_mode | optional (defaults to 'true') | boolean |
| EnableLostMode | lost_mode_with_sound | optional (defaults to 'false') | boolean |
| EraseDevice (deprecated on 2023-06-21)| preserve_data_plan | optional (defaults to 'false') | boolean |
| EraseDevice (deprecated on 2023-06-21)| disallow_proximity_setup | optional (defaults to 'false') | boolean |
| PasscodeLockGracePeriod | passcode_lock_grace_period | Shared iPad | seconds (integer) |
| PlayLostModeSound | N/A | Supervised and in lost mode | N/A |
| RestartDevice | N/A | Supervised device | N/A |
| SettingsDisableBluetooth (deprecated on 2024-04-24) | N/A | iOS 11.3+ and Supervised | N/A |
| SettingsEnableBluetooth (deprecated on 2024-04-24) | N/A | iOS 11.3+ and Supervised | N/A |

Below is a complete list of the supported values for the `command` element.

* BlankPush
* ClearPasscode
* ClearRestrictionsPassword (deprecated)
* DeviceLocation
* DisableLostMode
* EnableLostMode
* EraseDevice (deprecated)
* PasscodeLockGracePeriod
* PlayLostModeSound
* RestartDevice
* SettingsDisableDataRoaming (deprecated)
* SettingsDisableVoiceRoaming (deprecated)
* SettingsEnableDataRoaming (deprecated)
* SettingsEnableVoiceRoaming (deprecated)
* UnmanageDevice
* UpdateInventory

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "11.12.0",
    "title": "Classic API",
    "license": {
      "name": "Jamf API License Agreement",
      "url": "https://developer.jamf.com/developer-guide/docs/api-license-agreement"
    }
  },
  "security": [
    {
      "basicAuth": []
    }
  ],
  "x-readme": {
    "samples-languages": [
      "curl",
      "swift",
      "ruby",
      "python"
    ],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "paths": {
    "/mobiledevicecommands/command/{command}/id/{id_list}": {
      "post": {
        "x-explorer-enabled": false,
        "tags": [
          "mobiledevicecommands"
        ],
        "summary": "Creates a new mobile device command",
        "operationId": "createMobileDeviceCommandURL",
        "description": "The chart below includes additional requirements for usage of specific commands\n\n| command | Parameters | Requirements | Values |\n| ---------- | ------- | ------------ | ------ |\n| DeviceLocation | N/A | Supervised and in lost mode | N/A |\n| DisableLostMode | N/A | Supervised and in lost mode | N/A |\n| EnableLostMode | lost_mode_message | Supervised device (required if lost_mode_phone is not set) | string |\n| EnableLostMode | lost_mode_phone | Supervised device (required if lost_mode_message is not set) | string |\n| EnableLostMode | lost_mode_footnote | optional | string |\n| EnableLostMode | always_enforce_lost_mode | optional (defaults to 'true') | boolean |\n| EnableLostMode | lost_mode_with_sound | optional (defaults to 'false') | boolean |\n| EraseDevice (deprecated on 2023-06-21)| preserve_data_plan | optional (defaults to 'false') | boolean |\n| EraseDevice (deprecated on 2023-06-21)| disallow_proximity_setup | optional (defaults to 'false') | boolean |\n| PasscodeLockGracePeriod | passcode_lock_grace_period | Shared iPad | seconds (integer) |\n| PlayLostModeSound | N/A | Supervised and in lost mode | N/A |\n| RestartDevice | N/A | Supervised device | N/A |\n| SettingsDisableBluetooth (deprecated on 2024-04-24) | N/A | iOS 11.3+ and Supervised | N/A |\n| SettingsEnableBluetooth (deprecated on 2024-04-24) | N/A | iOS 11.3+ and Supervised | N/A |\n",
        "parameters": [
          {
            "name": "id_list",
            "in": "path",
            "required": true,
            "description": "Mobile device ID values, multiple IDs may be separated by commas (e.g. /id/13,14,15)",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "command",
            "in": "path",
            "required": true,
            "description": "Command to send device",
            "schema": {
              "type": "string",
              "enum": [
                "BlankPush",
                "ClearPasscode",
                "ClearRestrictionsPassword (Deprecated 2024-04-11)",
                "DeviceLocation",
                "DisableLostMode",
                "EnableLostMode",
                "EraseDevice",
                "PasscodeLockGracePeriod",
                "PlayLostModeSound",
                "RestartDevice",
                "Settings",
                "SettingsEnablePersonalHotspot (Deprecated 2024-04-24)",
                "SettingsDisablePersonalHotspot (Deprecated 2024-04-24)",
                "SettingsDisableDataRoaming (Deprecated 2024-04-24)",
                "SettingsDisableVoiceRoaming (Deprecated 2024-04-24)",
                "SettingsEnableDataRoaming (Deprecated 2024-04-24)",
                "SettingsEnableVoiceRoaming",
                "UnmanageDevice (Deprecated on 2024-06-27)",
                "UpdateInventory"
              ]
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Created"
          }
        }
      }
    }
  },
  "x-si-base": "swagger.yaml",
  "x-github-repo": "jamf/Classic-API-Swagger-Specification",
  "x-github-sha": "070fac498a589aaa0958641a68e4065584fc244a",
  "servers": [
    {
      "url": "https://yourServer.jamfcloud.com/JSSResource"
    }
  ],
  "components": {
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      }
    }
  }
}
```