--- title: "Delete an Apple MDM" method: DELETE path: "/applemdms/{id}" tags: ["Apple MDM"] --- # Delete an Apple MDM `DELETE /applemdms/{id}` ## Request - Base URL: `https://console.jumpcloud.com/api/v2` - URL: `https://console.jumpcloud.com/api/v2/applemdms/{id}` - Auth: API key in header `x-api-key` - TypeScript: (a function with typed inputs; its response is checked against the schema) Removes an Apple MDM configuration. Warning: This is a destructive operation and will remove your Apple Push Certificates. We will no longer be able to manage your devices and the only recovery option is to re-register all devices into MDM. #### Sample Request ``` curl -X DELETE https://console.jumpcloud.com/api/v2/applemdms/{id} \ -H 'accept: application/json' \ -H 'content-type: application/json' \ -H 'x-api-key: {API_KEY}' ``` ## Headers - `x-org-id` string ## Response `200` - AppleMDM - `apnsPushTopic` string: The push topic assigned to this enrollment by Apple after uploading the Signed CSR plist. - `depServerTokenState` 'unknown' | 'missing' | 'valid' | 'expired': The state of the dep server token, presence and expiry. - `id` string, required: ObjectId uniquely identifying an MDM Enrollment, - `name` string: A friendly name to identify this enrollment. Not required to be unique. - `organization` string: The identifier for an organization - `apnsCertExpiry` string, nullable: The expiration date and time for the APNS Certificate. - `depAccessTokenExpiry` string, nullable: The expiration date and time for the DEP Access Token. This aligns with the DEP Server Token State. - `defaultSystemGroupID` string, nullable: ObjectId uniquely identifying the MDM default System Group. - `defaultIosUserEnrollmentDeviceGroupID` string, nullable: ObjectId uniquely identifying the MDM default iOS user enrollment device group. - `dep` DEP - `welcomeScreen` DEPWelcomeScreen - `title` string, nullable: The title to display on the DEP Welcome Screen. - `paragraph` string, nullable: A message to display on the DEP Welcome Screen. - `button` string, nullable: Text to display on the button on the DEP Welcome Screen. - `setupAssistantOptions` DEPSetupAssistantOption[] - `option` 'accessibility' | 'actionButton' | 'appearance' | 'appleID' | 'biometric' | 'cameraButton' | 'diagnostics' | 'displayTone' | 'enableLockdownMode' | 'fileVault' | 'icloudDiagnostics' | 'icloudStorage' | 'intelligence' | 'location' | 'payment' | 'privacy' | 'restore' | 'safety' | 'screenTime' | 'siri' | 'tos' | 'termsOfAddress' | 'appStore' | 'displayZoom' | 'deviceToDeviceMigration' | 'homeButton' | 'imessageAndFacetime' | 'messagingActivationUsingPhoneNumber' | 'moveFromAndroid' | 'passcode' | 'restoreComplete' | 'setupCellular' | 'softwareUpdate' | 'unlockWithWatch' | 'updateComplete' | 'wallpaper' | 'watchMigration' | 'welcome' | 'additionalPrivacySettings' | 'multitasking' | 'osShowcase' | 'webContentFiltering' | 'safetyAndHandling' | 'liquidGlass': Options to skip screens during MacOS and iOS setup: * `accessibility` - Skips the Accessibility pane, only if the Mac is connected to Ethernet and the cloud config is downloaded. * `actionButton` - Skips the Action Button configuration pane. * `appearance` - Skips the Choose Your Look screen. * `appleID` - Skips Apple ID setup. * `biometric` - Skips biometric setup. * `cameraButton` - Skips the Camera Button configuration pane. * `diagnostics` - Skips the App Analytics pane. * `displayTone` - Skips display tone setup. * `enableLockdownMode` - Skips the Lockdown Mode pane. * `fileVault` - Skips FileVault setup assistant screen. * `icloudDiagnostics` - Skips iCloud analytics screen. * `icloudStorage` - Skips iCloud documents and desktop screen. * `intelligence` - Skips the Intelligence pane. * `location` - Skips location services setup. * `payment` - Skips Apple Pay setup. * `privacy` - Skips the Privacy setup. * `restore` - Skips restoring from backup. * `screenTime` - Skips screen time setup. * `siri` - Skips Siri setup. * `termsOfAddress` - Skips the Terms of Address pane. * `tos` - Skips terms and conditions. * `appStore` - Skips the App Store pane. * `deviceToDeviceMigration` - Skips Device to Device Migration pane. * `displayZoom` - Skips zoom setup. * `homeButton` - Skips the Meet the New Home Button screen on iPhone 7, iPhone 7 Plus, iPhone 8, iPhone 8 Plus and iPhone SE. * `imessageAndFacetime` - Skips the iMessage and FaceTime screen in iOS. * `messagingActivationUsingPhoneNumber` - Skips the iMessage pane. * `moveFromAndroid` - If the Restore pane is not skipped, removes the Move from Android option in the Restore pane on iOS.O * `passcode` - Hides and disables the passcode pane. * `restoreComplete` - Skips the Restore Completed pane. * `safety` - Skips the Safety pane. * `setupCellular` - Skips the add cellular plan pane. * `softwareUpdate` - Skips the mandatory software update screen in iOS. * `unlockWithWatch` - Skips Unlock Your Mac with your Apple Watch pane. * `updateComplete` - Skips the Software Update Complete pane. * `wallpaper` - Skips the Wallpaper setup. * `watchMigration` - Skips the screen for watch migration. * `welcome` - Skips the Get Started pane. * `additionalPrivacySettings` - Skips the Additional Privacy Settings pane. * `multitasking` - Skips the Multitasking pane. * `osShowcase` - Skips the OS Showcase pane. * `webContentFiltering` - Skips the Web Content Filtering pane. * `safetyAndHandling` - Skips the Safety and Handling pane. * `liquidGlass` - Skips the Liquid Glass pane. - `enableZeroTouchEnrollment` boolean: A toggle to determine if DEP registered devices should go through JumpCloud Zero Touch Enrollment. - `allowMobileUserEnrollment` boolean, nullable: A toggle to allow mobile device enrollment for an organization. - `ades` ADES - `macos` ADE - `welcomeScreen` DEPWelcomeScreen - `title` string, nullable: The title to display on the DEP Welcome Screen. - `paragraph` string, nullable: A message to display on the DEP Welcome Screen. - `button` string, nullable: Text to display on the button on the DEP Welcome Screen. - `setupAssistantOptions` DEPSetupAssistantOption[]: A Setup Option wrapped as an object - `option` 'accessibility' | 'actionButton' | 'appearance' | 'appleID' | 'biometric' | 'cameraButton' | 'diagnostics' | 'displayTone' | 'enableLockdownMode' | 'fileVault' | 'icloudDiagnostics' | 'icloudStorage' | 'intelligence' | 'location' | 'payment' | 'privacy' | 'restore' | 'safety' | 'screenTime' | 'siri' | 'tos' | 'termsOfAddress' | 'appStore' | 'displayZoom' | 'deviceToDeviceMigration' | 'homeButton' | 'imessageAndFacetime' | 'messagingActivationUsingPhoneNumber' | 'moveFromAndroid' | 'passcode' | 'restoreComplete' | 'setupCellular' | 'softwareUpdate' | 'unlockWithWatch' | 'updateComplete' | 'wallpaper' | 'watchMigration' | 'welcome' | 'additionalPrivacySettings' | 'multitasking' | 'osShowcase' | 'webContentFiltering' | 'safetyAndHandling' | 'liquidGlass': Options to skip screens during MacOS and iOS setup: * `accessibility` - Skips the Accessibility pane, only if the Mac is connected to Ethernet and the cloud config is downloaded. * `actionButton` - Skips the Action Button configuration pane. * `appearance` - Skips the Choose Your Look screen. * `appleID` - Skips Apple ID setup. * `biometric` - Skips biometric setup. * `cameraButton` - Skips the Camera Button configuration pane. * `diagnostics` - Skips the App Analytics pane. * `displayTone` - Skips display tone setup. * `enableLockdownMode` - Skips the Lockdown Mode pane. * `fileVault` - Skips FileVault setup assistant screen. * `icloudDiagnostics` - Skips iCloud analytics screen. * `icloudStorage` - Skips iCloud documents and desktop screen. * `intelligence` - Skips the Intelligence pane. * `location` - Skips location services setup. * `payment` - Skips Apple Pay setup. * `privacy` - Skips the Privacy setup. * `restore` - Skips restoring from backup. * `screenTime` - Skips screen time setup. * `siri` - Skips Siri setup. * `termsOfAddress` - Skips the Terms of Address pane. * `tos` - Skips terms and conditions. * `appStore` - Skips the App Store pane. * `deviceToDeviceMigration` - Skips Device to Device Migration pane. * `displayZoom` - Skips zoom setup. * `homeButton` - Skips the Meet the New Home Button screen on iPhone 7, iPhone 7 Plus, iPhone 8, iPhone 8 Plus and iPhone SE. * `imessageAndFacetime` - Skips the iMessage and FaceTime screen in iOS. * `messagingActivationUsingPhoneNumber` - Skips the iMessage pane. * `moveFromAndroid` - If the Restore pane is not skipped, removes the Move from Android option in the Restore pane on iOS.O * `passcode` - Hides and disables the passcode pane. * `restoreComplete` - Skips the Restore Completed pane. * `safety` - Skips the Safety pane. * `setupCellular` - Skips the add cellular plan pane. * `softwareUpdate` - Skips the mandatory software update screen in iOS. * `unlockWithWatch` - Skips Unlock Your Mac with your Apple Watch pane. * `updateComplete` - Skips the Software Update Complete pane. * `wallpaper` - Skips the Wallpaper setup. * `watchMigration` - Skips the screen for watch migration. * `welcome` - Skips the Get Started pane. * `additionalPrivacySettings` - Skips the Additional Privacy Settings pane. * `multitasking` - Skips the Multitasking pane. * `osShowcase` - Skips the OS Showcase pane. * `webContentFiltering` - Skips the Web Content Filtering pane. * `safetyAndHandling` - Skips the Safety and Handling pane. * `liquidGlass` - Skips the Liquid Glass pane. - `setupOptions` SetupAssistantOption[]: A list of configured setup options for this enrollment. - `enableZeroTouchEnrollment` boolean: A toggle to determine if ADE registered devices should go through JumpCloud Zero Touch Enrollment. - `defaultDeviceGroupObjectIds` string[], nullable: An array of ObjectIDs identifying the default device groups for this specific type (based on the OS family) of automated device enrollment. Currently, only a single DeviceGroupID is supported. - `ios` ADE - `welcomeScreen` DEPWelcomeScreen - `title` string, nullable: The title to display on the DEP Welcome Screen. - `paragraph` string, nullable: A message to display on the DEP Welcome Screen. - `button` string, nullable: Text to display on the button on the DEP Welcome Screen. - `setupAssistantOptions` DEPSetupAssistantOption[]: A Setup Option wrapped as an object - `option` 'accessibility' | 'actionButton' | 'appearance' | 'appleID' | 'biometric' | 'cameraButton' | 'diagnostics' | 'displayTone' | 'enableLockdownMode' | 'fileVault' | 'icloudDiagnostics' | 'icloudStorage' | 'intelligence' | 'location' | 'payment' | 'privacy' | 'restore' | 'safety' | 'screenTime' | 'siri' | 'tos' | 'termsOfAddress' | 'appStore' | 'displayZoom' | 'deviceToDeviceMigration' | 'homeButton' | 'imessageAndFacetime' | 'messagingActivationUsingPhoneNumber' | 'moveFromAndroid' | 'passcode' | 'restoreComplete' | 'setupCellular' | 'softwareUpdate' | 'unlockWithWatch' | 'updateComplete' | 'wallpaper' | 'watchMigration' | 'welcome' | 'additionalPrivacySettings' | 'multitasking' | 'osShowcase' | 'webContentFiltering' | 'safetyAndHandling' | 'liquidGlass': Options to skip screens during MacOS and iOS setup: * `accessibility` - Skips the Accessibility pane, only if the Mac is connected to Ethernet and the cloud config is downloaded. * `actionButton` - Skips the Action Button configuration pane. * `appearance` - Skips the Choose Your Look screen. * `appleID` - Skips Apple ID setup. * `biometric` - Skips biometric setup. * `cameraButton` - Skips the Camera Button configuration pane. * `diagnostics` - Skips the App Analytics pane. * `displayTone` - Skips display tone setup. * `enableLockdownMode` - Skips the Lockdown Mode pane. * `fileVault` - Skips FileVault setup assistant screen. * `icloudDiagnostics` - Skips iCloud analytics screen. * `icloudStorage` - Skips iCloud documents and desktop screen. * `intelligence` - Skips the Intelligence pane. * `location` - Skips location services setup. * `payment` - Skips Apple Pay setup. * `privacy` - Skips the Privacy setup. * `restore` - Skips restoring from backup. * `screenTime` - Skips screen time setup. * `siri` - Skips Siri setup. * `termsOfAddress` - Skips the Terms of Address pane. * `tos` - Skips terms and conditions. * `appStore` - Skips the App Store pane. * `deviceToDeviceMigration` - Skips Device to Device Migration pane. * `displayZoom` - Skips zoom setup. * `homeButton` - Skips the Meet the New Home Button screen on iPhone 7, iPhone 7 Plus, iPhone 8, iPhone 8 Plus and iPhone SE. * `imessageAndFacetime` - Skips the iMessage and FaceTime screen in iOS. * `messagingActivationUsingPhoneNumber` - Skips the iMessage pane. * `moveFromAndroid` - If the Restore pane is not skipped, removes the Move from Android option in the Restore pane on iOS.O * `passcode` - Hides and disables the passcode pane. * `restoreComplete` - Skips the Restore Completed pane. * `safety` - Skips the Safety pane. * `setupCellular` - Skips the add cellular plan pane. * `softwareUpdate` - Skips the mandatory software update screen in iOS. * `unlockWithWatch` - Skips Unlock Your Mac with your Apple Watch pane. * `updateComplete` - Skips the Software Update Complete pane. * `wallpaper` - Skips the Wallpaper setup. * `watchMigration` - Skips the screen for watch migration. * `welcome` - Skips the Get Started pane. * `additionalPrivacySettings` - Skips the Additional Privacy Settings pane. * `multitasking` - Skips the Multitasking pane. * `osShowcase` - Skips the OS Showcase pane. * `webContentFiltering` - Skips the Web Content Filtering pane. * `safetyAndHandling` - Skips the Safety and Handling pane. * `liquidGlass` - Skips the Liquid Glass pane. - `setupOptions` SetupAssistantOption[]: A list of configured setup options for this enrollment. - `enableZeroTouchEnrollment` boolean: A toggle to determine if ADE registered devices should go through JumpCloud Zero Touch Enrollment. - `defaultDeviceGroupObjectIds` string[], nullable: An array of ObjectIDs identifying the default device groups for this specific type (based on the OS family) of automated device enrollment. Currently, only a single DeviceGroupID is supported. - `appleCertCreatorAppleID` string: The Apple ID of the admin who created the Apple signed certificate associated to the Device Manager. - `appleCertSerialNumber` string: The serial number of the Apple signed certificate associated to the Device Manager. - `serviceDiscoveryEnabled` boolean, nullable: A flag to know whether service discovery is enabled or not for the Device Manager. ## Other responses - `400`: Bad Request - `401`: Unauthenticated - `403`: Unauthorized - `404`: Not Found - `409`: Conflict - `500`: Internal Server Error --- [API](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/revisions/3f09fe63caaa?raw)