---
updatedAt: 2026-09-08T13:22:47.000Z
agentTools:
  siteIndex: https://developer.jamf.com/llms.txt
  projectIndex: https://developer.jamf.com/jamf-pro/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 |
| PasscodeLockGracePeriod (PasscodeLockGracePeriod Deprecated on 2025-06-26) | passcode_lock_grace_period | Shared iPad | seconds (integer) |
| PlayLostModeSound | N/A | Supervised and in lost mode | N/A |
| RestartDevice (deprecated) | N/A | Supervised device | N/A |


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

* ClearPasscode
* ClearRestrictionsPassword (deprecated)
* DeviceLocation (deprecated)
* EnableLostMode
* PasscodeLockGracePeriod
* PlayLostModeSound (deprecated)
* UpdateInventory (deprecated)

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "11.32.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
  },
  "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| PasscodeLockGracePeriod (PasscodeLockGracePeriod Deprecated on 2025-06-26) | passcode_lock_grace_period | Shared iPad | seconds (integer) |\n| PlayLostModeSound | N/A | Supervised and in lost mode | N/A |\n| RestartDevice (deprecated) | N/A | Supervised device | 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(Deprecated on 2025-05-27)",
                "ClearPasscode (Deprecated on 2025-04-03)",
                "ClearRestrictionsPassword (Deprecated 2024-04-11)",
                "DeviceLocation",
                "DisableLostMode",
                "EnableLostMode",
                "PasscodeLockGracePeriod (PasscodeLockGracePeriod Deprecated on 2025-06-26)",
                "PlayLostModeSound",
                "RestartDevice (deprecated on 2025-02-25)",
                "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"
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://yourServer.jamfcloud.com/JSSResource"
    }
  ],
  "components": {
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      }
    }
  }
}
```