Favicon

You are here: Home > API Reference > Android > Devices > Update emmDevice

Update emmDevice

Required Permission: mdm.android.device.update

Update emmDevice

PUT
/v1/organizations/:organizationId/mdm/android/enterprise/devices/:emmDeviceId
Copy to clipboard

Update emmDevice

Required Permission: mdm.android.device.update

Update emmDevice

Request

Add parameter in header authorization
Example: Authorization: Bearer <token>
organizationId string
required
Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$
emmDeviceId string
required
Also support serialNumber, IMEI or enrollmentSpecificId obtained with method getEnrollmentTokenId
Match pattern: ^(([a-fA-F0-9]{24})|(\w{1,}))$
Body Params application/json
displayName string optional
≤ 128 characters
tags array [string] optional
state string optional
ACTIVE DISABLED
disabledReason string optional
≤ 4096 characters
policyId string optional
Match pattern: ^[a-fA-F0-9]{24}$
emmPolicyAssignments array [object] optional
emmPolicyId string optional
Match pattern: ^[a-fA-F0-9]{24}$
priority integer required
≥ 0 · ≤ 10000
mdmUserId string optional
Match pattern: ^[a-fA-F0-9]{24}$
segmentId number optional
Format: float
{
    "displayName": "string",
    "tags": [
        "string"
    ],
    "state": "ACTIVE",
    "disabledReason": "string",
    "policyId": "string",
    "emmPolicyAssignments": [
        {
            "emmPolicyId": "string",
            "priority": 0
        }
    ],
    "mdmUserId": "string",
    "segmentId": 0
}

Responses

200 Response application/json
status boolean optional
data object optional
id string optional
Match pattern: ^[a-fA-F0-9]{24}$
organization string optional
Match pattern: ^[a-fA-F0-9]{24}$
emmEnterprise string optional
Match pattern: ^[a-fA-F0-9]{24}$
mdmUser object optional
id string optional
Match pattern: ^[a-fA-F0-9]{24}$
email string optional
≤ 128 characters
deviceEmmPolicy object optional
id string optional
Unique Android Enterprise policy identifier used to track configuration rules and security settings throughout lifecycle.
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
Human-readable policy name displayed in dashboard for administrative identification and organizational purposes throughout device management.
≤ 128 characters
description string optional
Detailed policy description explaining configuration purpose business requirements and device restrictions for documentation purposes.
≤ 256 characters
version string optional
Policy version identifier synchronized with Google Android Enterprise policy version for change tracking purposes.
≤ 128 characters
config object optional
Google Android Enterprise policy configuration object containing device restrictions security settings and compliance rules.
_config object optional
Internal configuration data restricted to administrator access level containing sensitive policy credentials and system metadata.
packages object optional
Application package information mapping containing installed app details versions and configuration for reporting purposes.
emmEnterprise string optional
Android Enterprise (EMM) account identifier linked to Google Managed Play for device and application management.
Match pattern: ^[a-fA-F0-9]{24}$
private boolean optional
Flag indicating whether policy is private to organization or shared across enterprise for template purposes.
assets array [object] optional
List of asset assignments for deploying files certificates configuration data and resources to managed Android devices.
mdmAssetId string optional
Match pattern: ^[a-fA-F0-9]{24}$
location string optional
≤ 256 characters
assetName string optional
≤ 256 characters
scope string optional
user system all-users
assetsInfo array [object] optional
Enriched asset metadata including file sizes deployment status and version information for monitoring and auditing purposes.
updatedAt string optional
ISO timestamp of last policy modification for change tracking synchronization and audit trail purposes.
Format: date-time
createdAt string optional
ISO timestamp when policy was created in system for lifecycle tracking and compliance reporting purposes.
Format: date-time
agentConfiguration object optional
MDM agent behavior settings controlling location tracking application monitoring and network status reporting on Android devices.
allowLocation boolean optional
Flag enabling location tracking for Android devices through MDM agent for geofencing and asset management purposes.
allowPackageTime boolean optional
Flag enabling application usage time tracking for monitoring employee productivity and license optimization on Android.
allowPackageTransfer boolean optional
Flag enabling network data transfer monitoring per application for bandwidth analysis and security threat detection.
allowNetworkStatus boolean optional
Flag enabling network status monitoring including WiFi cellular and VPN connections for connectivity diagnostics.
kioskLauncherConfiguration object optional
Kiosk launcher customization settings defining home screen layout lock screen behavior and application restrictions for dedicated devices.
displayDeviceName boolean optional
Flag controlling whether device name is displayed in kiosk launcher header for identification in multi-device deployments.
settingAction any optional
Settings access permission level in kiosk mode defining which device settings users can modify from launcher.
whitelistedApps array [string] optional
List of application package names allowed to run in kiosk mode restricting users to approved applications.
escapeHatchPassword string optional
Administrator password for exiting kiosk mode enabling device reconfiguration without factory reset for support scenarios.
≤ 256 characters
backgroundUrl string optional
Custom wallpaper image URL for kiosk launcher background providing branded visual identity on dedicated devices.
≤ 500 characters
iconSize any optional
Application icon display size in kiosk launcher grid controlling visual density and accessibility for users.
screenAlwaysOn boolean optional
Flag keeping device screen permanently active preventing sleep mode for always-available kiosk displays and dashboards.
unlockPassword string optional
User password required to unlock device from lock screen providing basic security for kiosk deployments.
≤ 256 characters
inactivityLockTime integer optional
Seconds of inactivity before automatically locking device screen protecting kiosk from unauthorized access when idle.
≥ 0
startingUpApps array [object] optional
List of applications automatically launched at device startup with optional configuration for kiosk initialization workflow.
packageName string optional
Application package name to auto-launch at startup initializing kiosk mode with specific application.
≤ 256 characters
config object optional
Startup application configuration parameters passed during launch for customizing initial app behavior.
appsLayout array [object] optional
Custom home screen layout defining application grid organization with apps actions folders for optimized kiosk navigation.
type string required
app
package string required
≤ 256 characters
header object optional
Kiosk launcher header section configuration containing custom text and styling for branded information display.
text string optional
Custom text content displayed in header section of kiosk launcher for company branding or instructions.
≤ 1000 characters
fontSize string optional
Text size for header content controlling visual prominence and readability in kiosk layout.
small medium large
footer object optional
Kiosk launcher footer section configuration containing custom text and styling for supplementary information display.
text string optional
Custom text content displayed in footer section of kiosk launcher for support information or disclaimers.
≤ 1000 characters
fontSize string optional
Text size for footer content controlling layout balance and emphasis in kiosk interface design.
small medium large
certificateProviderIds array [string] optional
List of certificate provider identifiers for deploying PKI credentials and authentication certificates to Android devices.
applications array [object] optional
List of application assignments defining managed apps with installation actions configuration and update policies for deployment.
emmApplicationId string optional
Match pattern: ^[a-fA-F0-9]{24}$
configuration string optional
action string optional
forceInstall available
updatePolicy object optional
customAppConfig object optional
applicationsInfo array [object] optional
Enriched application metadata including app details names icons versions for dashboard display and reporting purposes.
emmApplicationId string optional
Match pattern: ^[a-fA-F0-9]{24}$
emmApplication object optional
segmentId integer optional
Segment identifier for scoping policy into an specific segment
≥ 0
appliedEmmPolicy object optional
id string optional
Unique Android Enterprise policy identifier used to track configuration rules and security settings throughout lifecycle.
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
Human-readable policy name displayed in dashboard for administrative identification and organizational purposes throughout device management.
≤ 128 characters
description string optional
Detailed policy description explaining configuration purpose business requirements and device restrictions for documentation purposes.
≤ 256 characters
version string optional
Policy version identifier synchronized with Google Android Enterprise policy version for change tracking purposes.
≤ 128 characters
config object optional
Google Android Enterprise policy configuration object containing device restrictions security settings and compliance rules.
_config object optional
Internal configuration data restricted to administrator access level containing sensitive policy credentials and system metadata.
packages object optional
Application package information mapping containing installed app details versions and configuration for reporting purposes.
emmEnterprise string optional
Android Enterprise (EMM) account identifier linked to Google Managed Play for device and application management.
Match pattern: ^[a-fA-F0-9]{24}$
private boolean optional
Flag indicating whether policy is private to organization or shared across enterprise for template purposes.
assets array [object] optional
List of asset assignments for deploying files certificates configuration data and resources to managed Android devices.
mdmAssetId string optional
Match pattern: ^[a-fA-F0-9]{24}$
location string optional
≤ 256 characters
assetName string optional
≤ 256 characters
scope string optional
user system all-users
assetsInfo array [object] optional
Enriched asset metadata including file sizes deployment status and version information for monitoring and auditing purposes.
updatedAt string optional
ISO timestamp of last policy modification for change tracking synchronization and audit trail purposes.
Format: date-time
createdAt string optional
ISO timestamp when policy was created in system for lifecycle tracking and compliance reporting purposes.
Format: date-time
agentConfiguration object optional
MDM agent behavior settings controlling location tracking application monitoring and network status reporting on Android devices.
allowLocation boolean optional
Flag enabling location tracking for Android devices through MDM agent for geofencing and asset management purposes.
allowPackageTime boolean optional
Flag enabling application usage time tracking for monitoring employee productivity and license optimization on Android.
allowPackageTransfer boolean optional
Flag enabling network data transfer monitoring per application for bandwidth analysis and security threat detection.
allowNetworkStatus boolean optional
Flag enabling network status monitoring including WiFi cellular and VPN connections for connectivity diagnostics.
kioskLauncherConfiguration object optional
Kiosk launcher customization settings defining home screen layout lock screen behavior and application restrictions for dedicated devices.
displayDeviceName boolean optional
Flag controlling whether device name is displayed in kiosk launcher header for identification in multi-device deployments.
settingAction any optional
Settings access permission level in kiosk mode defining which device settings users can modify from launcher.
whitelistedApps array [string] optional
List of application package names allowed to run in kiosk mode restricting users to approved applications.
escapeHatchPassword string optional
Administrator password for exiting kiosk mode enabling device reconfiguration without factory reset for support scenarios.
≤ 256 characters
backgroundUrl string optional
Custom wallpaper image URL for kiosk launcher background providing branded visual identity on dedicated devices.
≤ 500 characters
iconSize any optional
Application icon display size in kiosk launcher grid controlling visual density and accessibility for users.
screenAlwaysOn boolean optional
Flag keeping device screen permanently active preventing sleep mode for always-available kiosk displays and dashboards.
unlockPassword string optional
User password required to unlock device from lock screen providing basic security for kiosk deployments.
≤ 256 characters
inactivityLockTime integer optional
Seconds of inactivity before automatically locking device screen protecting kiosk from unauthorized access when idle.
≥ 0
startingUpApps array [object] optional
List of applications automatically launched at device startup with optional configuration for kiosk initialization workflow.
packageName string optional
Application package name to auto-launch at startup initializing kiosk mode with specific application.
≤ 256 characters
config object optional
Startup application configuration parameters passed during launch for customizing initial app behavior.
appsLayout array [object] optional
Custom home screen layout defining application grid organization with apps actions folders for optimized kiosk navigation.
type string required
app
package string required
≤ 256 characters
header object optional
Kiosk launcher header section configuration containing custom text and styling for branded information display.
text string optional
Custom text content displayed in header section of kiosk launcher for company branding or instructions.
≤ 1000 characters
fontSize string optional
Text size for header content controlling visual prominence and readability in kiosk layout.
small medium large
footer object optional
Kiosk launcher footer section configuration containing custom text and styling for supplementary information display.
text string optional
Custom text content displayed in footer section of kiosk launcher for support information or disclaimers.
≤ 1000 characters
fontSize string optional
Text size for footer content controlling layout balance and emphasis in kiosk interface design.
small medium large
certificateProviderIds array [string] optional
List of certificate provider identifiers for deploying PKI credentials and authentication certificates to Android devices.
applications array [object] optional
List of application assignments defining managed apps with installation actions configuration and update policies for deployment.
emmApplicationId string optional
Match pattern: ^[a-fA-F0-9]{24}$
configuration string optional
action string optional
forceInstall available
updatePolicy object optional
customAppConfig object optional
applicationsInfo array [object] optional
Enriched application metadata including app details names icons versions for dashboard display and reporting purposes.
emmApplicationId string optional
Match pattern: ^[a-fA-F0-9]{24}$
emmApplication object optional
segmentId integer optional
Segment identifier for scoping policy into an specific segment
≥ 0
emmPolicy object optional
id string optional
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
≤ 128 characters
version string optional
≤ 128 characters
emmPolicyAssignments array [object] optional
emmPolicyId string optional
Android Enterprise policy unique identifier for assignment tracking and composition operations.
Match pattern: ^[a-fA-F0-9]{24}$
emmPolicy object optional
Complete Android Enterprise policy object with device restrictions, application deployments, and security configurations.
id string optional
Unique Android Enterprise policy identifier used to track configuration rules and security settings throughout lifecycle.
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
Human-readable policy name displayed in dashboard for administrative identification and organizational purposes throughout device management.
≤ 128 characters
description string optional
Detailed policy description explaining configuration purpose business requirements and device restrictions for documentation purposes.
≤ 256 characters
version string optional
Policy version identifier synchronized with Google Android Enterprise policy version for change tracking purposes.
≤ 128 characters
config object optional
Google Android Enterprise policy configuration object containing device restrictions security settings and compliance rules.
_config object optional
Internal configuration data restricted to administrator access level containing sensitive policy credentials and system metadata.
packages object optional
Application package information mapping containing installed app details versions and configuration for reporting purposes.
emmEnterprise string optional
Android Enterprise (EMM) account identifier linked to Google Managed Play for device and application management.
Match pattern: ^[a-fA-F0-9]{24}$
private boolean optional
Flag indicating whether policy is private to organization or shared across enterprise for template purposes.
assets array [object] optional
List of asset assignments for deploying files certificates configuration data and resources to managed Android devices.
mdmAssetId string optional
Match pattern: ^[a-fA-F0-9]{24}$
location string optional
≤ 256 characters
assetName string optional
≤ 256 characters
scope string optional
user system all-users
assetsInfo array [object] optional
Enriched asset metadata including file sizes deployment status and version information for monitoring and auditing purposes.
updatedAt string optional
ISO timestamp of last policy modification for change tracking synchronization and audit trail purposes.
Format: date-time
createdAt string optional
ISO timestamp when policy was created in system for lifecycle tracking and compliance reporting purposes.
Format: date-time
agentConfiguration object optional
MDM agent behavior settings controlling location tracking application monitoring and network status reporting on Android devices.
allowLocation boolean optional
Flag enabling location tracking for Android devices through MDM agent for geofencing and asset management purposes.
allowPackageTime boolean optional
Flag enabling application usage time tracking for monitoring employee productivity and license optimization on Android.
allowPackageTransfer boolean optional
Flag enabling network data transfer monitoring per application for bandwidth analysis and security threat detection.
allowNetworkStatus boolean optional
Flag enabling network status monitoring including WiFi cellular and VPN connections for connectivity diagnostics.
kioskLauncherConfiguration object optional
Kiosk launcher customization settings defining home screen layout lock screen behavior and application restrictions for dedicated devices.
displayDeviceName boolean optional
Flag controlling whether device name is displayed in kiosk launcher header for identification in multi-device deployments.
settingAction any optional
Settings access permission level in kiosk mode defining which device settings users can modify from launcher.
whitelistedApps array [string] optional
List of application package names allowed to run in kiosk mode restricting users to approved applications.
escapeHatchPassword string optional
Administrator password for exiting kiosk mode enabling device reconfiguration without factory reset for support scenarios.
≤ 256 characters
backgroundUrl string optional
Custom wallpaper image URL for kiosk launcher background providing branded visual identity on dedicated devices.
≤ 500 characters
iconSize any optional
Application icon display size in kiosk launcher grid controlling visual density and accessibility for users.
screenAlwaysOn boolean optional
Flag keeping device screen permanently active preventing sleep mode for always-available kiosk displays and dashboards.
unlockPassword string optional
User password required to unlock device from lock screen providing basic security for kiosk deployments.
≤ 256 characters
inactivityLockTime integer optional
Seconds of inactivity before automatically locking device screen protecting kiosk from unauthorized access when idle.
≥ 0
startingUpApps array [object] optional
List of applications automatically launched at device startup with optional configuration for kiosk initialization workflow.
appsLayout array [object] optional
Custom home screen layout defining application grid organization with apps actions folders for optimized kiosk navigation.
header object optional
Kiosk launcher header section configuration containing custom text and styling for branded information display.
footer object optional
Kiosk launcher footer section configuration containing custom text and styling for supplementary information display.
certificateProviderIds array [string] optional
List of certificate provider identifiers for deploying PKI credentials and authentication certificates to Android devices.
applications array [object] optional
List of application assignments defining managed apps with installation actions configuration and update policies for deployment.
emmApplicationId string optional
Match pattern: ^[a-fA-F0-9]{24}$
configuration string optional
action string optional
forceInstall available
updatePolicy object optional
customAppConfig object optional
applicationsInfo array [object] optional
Enriched application metadata including app details names icons versions for dashboard display and reporting purposes.
emmApplicationId string optional
Match pattern: ^[a-fA-F0-9]{24}$
emmApplication object optional
segmentId integer optional
Segment identifier for scoping policy into an specific segment
≥ 0
priority integer optional
Policy assignment priority determining precedence when multiple policies apply to device for conflict resolution.
≥ 0
emmPolicyAssignmentsEnforced array [object] optional
emmPolicyId string optional
Android Enterprise policy unique identifier for assignment tracking and composition operations.
Match pattern: ^[a-fA-F0-9]{24}$
emmPolicy object optional
Complete Android Enterprise policy object with device restrictions, application deployments, and security configurations.
id string optional
Unique Android Enterprise policy identifier used to track configuration rules and security settings throughout lifecycle.
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
Human-readable policy name displayed in dashboard for administrative identification and organizational purposes throughout device management.
≤ 128 characters
description string optional
Detailed policy description explaining configuration purpose business requirements and device restrictions for documentation purposes.
≤ 256 characters
version string optional
Policy version identifier synchronized with Google Android Enterprise policy version for change tracking purposes.
≤ 128 characters
config object optional
Google Android Enterprise policy configuration object containing device restrictions security settings and compliance rules.
_config object optional
Internal configuration data restricted to administrator access level containing sensitive policy credentials and system metadata.
packages object optional
Application package information mapping containing installed app details versions and configuration for reporting purposes.
emmEnterprise string optional
Android Enterprise (EMM) account identifier linked to Google Managed Play for device and application management.
Match pattern: ^[a-fA-F0-9]{24}$
private boolean optional
Flag indicating whether policy is private to organization or shared across enterprise for template purposes.
assets array [object] optional
List of asset assignments for deploying files certificates configuration data and resources to managed Android devices.
mdmAssetId string optional
Match pattern: ^[a-fA-F0-9]{24}$
location string optional
≤ 256 characters
assetName string optional
≤ 256 characters
scope string optional
user system all-users
assetsInfo array [object] optional
Enriched asset metadata including file sizes deployment status and version information for monitoring and auditing purposes.
updatedAt string optional
ISO timestamp of last policy modification for change tracking synchronization and audit trail purposes.
Format: date-time
createdAt string optional
ISO timestamp when policy was created in system for lifecycle tracking and compliance reporting purposes.
Format: date-time
agentConfiguration object optional
MDM agent behavior settings controlling location tracking application monitoring and network status reporting on Android devices.
allowLocation boolean optional
Flag enabling location tracking for Android devices through MDM agent for geofencing and asset management purposes.
allowPackageTime boolean optional
Flag enabling application usage time tracking for monitoring employee productivity and license optimization on Android.
allowPackageTransfer boolean optional
Flag enabling network data transfer monitoring per application for bandwidth analysis and security threat detection.
allowNetworkStatus boolean optional
Flag enabling network status monitoring including WiFi cellular and VPN connections for connectivity diagnostics.
kioskLauncherConfiguration object optional
Kiosk launcher customization settings defining home screen layout lock screen behavior and application restrictions for dedicated devices.
displayDeviceName boolean optional
Flag controlling whether device name is displayed in kiosk launcher header for identification in multi-device deployments.
settingAction any optional
Settings access permission level in kiosk mode defining which device settings users can modify from launcher.
whitelistedApps array [string] optional
List of application package names allowed to run in kiosk mode restricting users to approved applications.
escapeHatchPassword string optional
Administrator password for exiting kiosk mode enabling device reconfiguration without factory reset for support scenarios.
≤ 256 characters
backgroundUrl string optional
Custom wallpaper image URL for kiosk launcher background providing branded visual identity on dedicated devices.
≤ 500 characters
iconSize any optional
Application icon display size in kiosk launcher grid controlling visual density and accessibility for users.
screenAlwaysOn boolean optional
Flag keeping device screen permanently active preventing sleep mode for always-available kiosk displays and dashboards.
unlockPassword string optional
User password required to unlock device from lock screen providing basic security for kiosk deployments.
≤ 256 characters
inactivityLockTime integer optional
Seconds of inactivity before automatically locking device screen protecting kiosk from unauthorized access when idle.
≥ 0
startingUpApps array [object] optional
List of applications automatically launched at device startup with optional configuration for kiosk initialization workflow.
appsLayout array [object] optional
Custom home screen layout defining application grid organization with apps actions folders for optimized kiosk navigation.
header object optional
Kiosk launcher header section configuration containing custom text and styling for branded information display.
footer object optional
Kiosk launcher footer section configuration containing custom text and styling for supplementary information display.
certificateProviderIds array [string] optional
List of certificate provider identifiers for deploying PKI credentials and authentication certificates to Android devices.
applications array [object] optional
List of application assignments defining managed apps with installation actions configuration and update policies for deployment.
emmApplicationId string optional
Match pattern: ^[a-fA-F0-9]{24}$
configuration string optional
action string optional
forceInstall available
updatePolicy object optional
customAppConfig object optional
applicationsInfo array [object] optional
Enriched application metadata including app details names icons versions for dashboard display and reporting purposes.
emmApplicationId string optional
Match pattern: ^[a-fA-F0-9]{24}$
emmApplication object optional
segmentId integer optional
Segment identifier for scoping policy into an specific segment
≥ 0
priority integer optional
Policy assignment priority determining precedence when multiple policies apply to device for conflict resolution.
≥ 0
automationRule object optional
Automation rule object documenting which rule triggered policy assignment for audit trails and compliance reports.
id string optional
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
≤ 256 characters
deviceAudiences array [object] optional
id string optional
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
≤ 256 characters
reasons array [string] optional
state string optional
ACTIVE DISABLED DELETED PROVISIONING
displayName string optional
≤ 128 characters
tags array [string] optional
hasApplications boolean optional
config object optional
apiLevel integer optional
≥ 0
appliedPolicyVersion string optional
≤ 128 characters
appliedState string optional
ACTIVE DISABLED DELETED PROVISIONING
disabledReason object optional
localizedMessages object optional
defaultMessage string optional
enrollmentTime string optional
Format: date-time
displays array [object] optional
name string optional
≤ 128 characters
displayId integer optional
≥ 0
refreshRate integer optional
≥ 0
state string optional
DISPLAY_STATE_UNSPECIFIED OFF ON DOZE SUSPENDED
width integer optional
≥ 0
height integer optional
≥ 0
density integer optional
≥ 0
applicationReports string optional
hardwareInfo object optional
brand string optional
≤ 128 characters
hardware string optional
≤ 128 characters
deviceBasebandVersion string optional
≤ 128 characters
manufacturer string optional
≤ 128 characters
serialNumber string optional
≤ 128 characters
model string optional
≤ 128 characters
batteryShutdownTemperatures array optional
batteryThrottlingTemperatures array optional
cpuShutdownTemperatures array optional
cpuThrottlingTemperatures array optional
gpuShutdownTemperatures array optional
gpuThrottlingTemperatures array optional
skinShutdownTemperatures array optional
skinThrottlingTemperatures array optional
lastPolicySyncTime string optional
Format: date-time
lastStatusReportTime string optional
Format: date-time
managementMode string optional
MANAGEMENT_MODE_UNSPECIFIED DEVICE_OWNER PROFILE_OWNER
memoryInfo object optional
totalInternalStorage string optional
≤ 128 characters
totalRam string optional
≤ 128 characters
memoryEvents array [object] optional
eventType string optional
MEMORY_EVENT_TYPE_UNSPECIFIED RAM_MEASURED INTERNAL_STORAGE_MEASURED EXTERNAL_STORAGE_DETECTED EXTERNAL_STORAGE_REMOVED EXTERNAL_STORAGE_MEASURED
createTime string optional
≤ 128 characters
byteCount string optional
≤ 128 characters
powerManagementEvents array [object] optional
eventType string optional
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED BATTERY_LEVEL_COLLECTED POWER_CONNECTED POWER_DISCONNECTED BATTERY_LOW BATTERY_OKAY BOOT_COMPLETED SHUTDOWN
createTime string optional
≤ 128 characters
batteryLevel integer optional
≥ 0
hardwareStatusSamples object optional
createTime string optional
≤ 128 characters
batteryTemperatures array [number] optional
cpuTemperatures array [number] optional
gpuTemperatures array [number] optional
skinTemperatures array [number] optional
fanSpeeds array [number] optional
cpuUsages array [number] optional
networkInfo object optional
imei string optional
≤ 128 characters
meid string optional
≤ 128 characters
wifiMacAddress string optional
≤ 128 characters
networkOperatorName string optional
≤ 128 characters
telephonyInfos array [object] optional
phoneNumber string optional
≤ 128 characters
carrierName string optional
≤ 128 characters
deviceSettings object optional
isDeviceSecure boolean optional
unknownSourcesEnabled boolean optional
developmentSettingsEnabled boolean optional
adbEnabled boolean optional
isEncrypted boolean optional
encryptionStatus string optional
ENCRYPTION_STATUS_UNSPECIFIED UNSUPPORTED INACTIVE ACTIVATING ACTIVE ACTIVE_DEFAULT_KEY ACTIVE_PER_USER
verifyAppsEnabled boolean optional
policyCompliant boolean optional
previousDeviceNames array [string] optional
securityPosture object optional
devicePosture string optional
SECURE AT_RISK POTENTIALLY_COMPROMISED
postureDetails array [object] optional
securityRisk string optional
SECURITY_RISK_UNSPECIFIED UNKNOWN_OS COMPROMISED_OS HARDWARE_BACKED_EVALUATION_FAILED
advice object optional
softwareInfo object optional
androidBuildNumber string optional
≤ 128 characters
androidBuildTime string optional
Format: date-time
androidDevicePolicyVersionCode integer optional
≥ 0
androidDevicePolicyVersionName string optional
≤ 128 characters
androidVersion string optional
≤ 128 characters
bootloaderVersion string optional
≤ 128 characters
deviceBuildSignature string optional
≤ 256 characters
deviceKernelVersion string optional
≤ 128 characters
primaryLanguageCode string optional
≤ 128 characters
securityPatchLevel string optional
≤ 128 characters
systemUpdateInfo object optional
updateStatus string optional
UPDATE_STATUS_UNKNOWN UP_TO_DATE UNKNOWN_UPDATE_AVAILABLE SECURITY_UPDATE_AVAILABLE OS_UPDATE_AVAILABLE
updateReceivedTime string optional
Format: date-time
systemProperties string optional
ownership string optional
OWNERSHIP_UNSPECIFIED COMPANY_OWNED PERSONALLY_OWNED
state string optional
ACTIVE DISABLED DELETED PROVISIONING
nonComplianceDetails array [object] optional
settingName string optional
≤ 128 characters
nonComplianceReason string optional
API_LEVEL MANAGEMENT_MODE USER_ACTION INVALID_VALUE APP_NOT_INSTALLED UNSUPPORTED APP_INSTALLED PENDING APP_INCOMPATIBLE APP_NOT_UPDATED
packageName string optional
≤ 256 characters
installationFailureReason string optional
INSTALLATION_FAILURE_REASON_UNKNOWN IN_PROGRESS NOT_FOUND NOT_COMPATIBLE_WITH_DEVICE NOT_APPROVED PERMISSIONS_NOT_ACCEPTED NOT_AVAILABLE_IN_COUNTRY NO_LICENSES_REMAINING NOT_ENROLLED USER_INVALID
fieldPath string optional
≤ 256 characters
commonCriteriaModeInfo object optional
commonCriteriaModeStatus string optional
COMMON_CRITERIA_MODE_STATUS_UNKNOWN COMMON_CRITERIA_MODE_DISABLED COMMON_CRITERIA_MODE_ENABLED
certificateReport array [object] optional
origin string optional
mdmAsset certificateProvider
originId string optional
Match pattern: ^[a-fA-F0-9]{24}$
state string optional
installed fail pending
errorCode string optional
≤ 256 characters
errorMessage string optional
≤ 1000 characters
updatedAt string optional
Format: date-time
challenge string optional
≤ 256 characters
keyPairAlias string optional
≤ 256 characters
commonName string optional
≤ 256 characters
isIdentity boolean optional
certificateInfo object optional
issuer string optional
≤ 256 characters
serialNumber string optional
≤ 256 characters
subject string optional
≤ 256 characters
subjectAltName string optional
≤ 256 characters
validFrom string optional
Format: date-time
validTo string optional
Format: date-time
_config object optional
Only available for platform admin users
summary object optional
name string optional
≤ 256 characters
osVersion string optional
≤ 128 characters
managementMode string optional
DEVICE_OWNER
imei string optional
≤ 128 characters
battery string optional
≤ 128 characters
os string optional
≤ 128 characters
serialNumber string optional
≤ 128 characters
image string optional
≤ 128 characters
compliance object optional
manufacturer string optional
≤ 128 characters
model string optional
≤ 128 characters
udid string optional
≤ 128 characters
hostname string optional
≤ 128 characters
ipAddress string optional
≤ 128 characters
macAddress string optional
≤ 128 characters
type string optional
≤ 128 characters
subType string optional
≤ 128 characters
lastLocation object optional
agent object optional
origin string optional
agent ip
date string optional
Format: date-time
latitude number optional
Format: float · ≥ -90 · ≤ 90
longitude number optional
Format: float · ≥ -180 · ≤ 180
ip string optional
≤ 128 characters
lastReportDate string optional
Format: date-time
address object optional
address string optional
≤ 500 characters
number string optional
≤ 500 characters
postalCode string optional
≤ 500 characters
city string optional
≤ 500 characters
country string optional
≤ 500 characters
ip object optional
origin string optional
agent ip
date string optional
Format: date-time
latitude number optional
Format: float · ≥ -90 · ≤ 90
longitude number optional
Format: float · ≥ -180 · ≤ 180
ip string optional
≤ 128 characters
lastReportDate string optional
Format: date-time
address object optional
address string optional
≤ 500 characters
number string optional
≤ 500 characters
postalCode string optional
≤ 500 characters
city string optional
≤ 500 characters
country string optional
≤ 500 characters
lastStatusReportTime string optional
Format: date-time
stateHistory array [object] optional
state string optional
ACTIVE DISABLED DELETED PROVISIONING
date string optional
Format: date-time
config object optional
lastReports object optional
sync string optional
Format: date-time
agent object optional
location string optional
Format: date-time
packageTime string optional
Format: date-time
packageTransfer string optional
Format: date-time
lostMode object optional
enabled boolean optional
startDate string optional
Format: date-time
endDate string optional
Format: date-time
stoppedBy string optional
admin user
lastLocation object optional
latitude integer optional
≥ 0
longitude integer optional
≥ 0
batteryLevel integer optional
≥ 0
certificateReport array [object] optional
origin string optional
mdmAsset certificateProvider
originId string optional
Match pattern: ^[a-fA-F0-9]{24}$
state string optional
installed fail pending
errorCode string optional
≤ 256 characters
errorMessage string optional
≤ 1000 characters
updatedAt string optional
Format: date-time
challenge string optional
≤ 256 characters
keyPairAlias string optional
≤ 256 characters
commonName string optional
≤ 256 characters
data string optional
≤ 256 characters
isIdentity boolean optional
certificateInfo object optional
issuer string optional
≤ 256 characters
serialNumber string optional
≤ 256 characters
subject string optional
≤ 256 characters
subjectAltName string optional
≤ 256 characters
validFrom string optional
Format: date-time
validTo string optional
Format: date-time
enrolledDate string optional
Format: date-time
pushNotifications object optional
mdmAgent boolean optional
remoteSupport boolean optional
kioskLauncher boolean optional
updatedAt string optional
Format: date-time
createdAt string optional
Format: date-time
segmentId integer optional
≥ 0
devicePolicyStatus object optional
pushed boolean optional
audit object optional
name string optional
≤ 128 characters
config object optional
version string optional
≤ 128 characters
device object optional
version string optional
≤ 128 characters
{
    "status": true,
    "data": {
        "id": "string",
        "organization": "string",
        "emmEnterprise": "string",
        "mdmUser": {
            "id": "string",
            "email": "string"
        },
        "deviceEmmPolicy": {
            "id": "698f42e5457fafa13d088794",
            "name": "Corporate Security Policy - Android",
            "description": "Standard security policy for corporate Android devices with app restrictions",
            "version": "1",
            "config": {},
            "_config": {},
            "packages": {},
            "emmEnterprise": "698f42e5457fafa13d088795",
            "private": false,
            "assets": [
                {
                    "mdmAssetId": "698f42e5457fafa13d088796",
                    "location": "/sdcard/Company/config.json",
                    "assetName": "App Configuration",
                    "scope": "user"
                }
            ],
            "assetsInfo": [],
            "updatedAt": "2026-02-13T14: 30:00Z",
            "createdAt": "2026-02-13T10: 00:00Z",
            "agentConfiguration": {
                "allowLocation": true,
                "allowPackageTime": true,
                "allowPackageTransfer": true,
                "allowNetworkStatus": true
            },
            "kioskLauncherConfiguration": {
                "displayDeviceName": true,
                "settingAction": "GLOBAL",
                "whitelistedApps": [
                    "com.company.app1",
                    "com.company.app2"
                ],
                "escapeHatchPassword": "",
                "backgroundUrl": "https://cdn.company.com/wallpaper.jpg",
                "iconSize": "medium",
                "screenAlwaysOn": true,
                "unlockPassword": "",
                "inactivityLockTime": 300,
                "startingUpApps": [
                    {
                        "packageName": "com.company.dashboard",
                        "config": {}
                    }
                ],
                "appsLayout": [
                    {
                        "type": "app",
                        "package": "com.company.app1"
                    }
                ],
                "header": {
                    "text": "Company Name",
                    "fontSize": "large"
                },
                "footer": {
                    "text": "Support: [email protected]",
                    "fontSize": "small"
                }
            },
            "certificateProviderIds": [
                "698f42e5457fafa13d088797",
                "698f42e5457fafa13d088798"
            ],
            "applications": [
                {
                    "emmApplicationId": "string",
                    "configuration": "string",
                    "action": "forceInstall",
                    "updatePolicy": {},
                    "customAppConfig": {}
                }
            ],
            "applicationsInfo": [
                {
                    "emmApplicationId": "698f42e5457fafa13d088799",
                    "emmApplication": {}
                }
            ],
            "segmentId": 1
        },
        "appliedEmmPolicy": {
            "id": "698f42e5457fafa13d088794",
            "name": "Corporate Security Policy - Android",
            "description": "Standard security policy for corporate Android devices with app restrictions",
            "version": "1",
            "config": {},
            "_config": {},
            "packages": {},
            "emmEnterprise": "698f42e5457fafa13d088795",
            "private": false,
            "assets": [
                {
                    "mdmAssetId": "698f42e5457fafa13d088796",
                    "location": "/sdcard/Company/config.json",
                    "assetName": "App Configuration",
                    "scope": "user"
                }
            ],
            "assetsInfo": [],
            "updatedAt": "2026-02-13T14: 30:00Z",
            "createdAt": "2026-02-13T10: 00:00Z",
            "agentConfiguration": {
                "allowLocation": true,
                "allowPackageTime": true,
                "allowPackageTransfer": true,
                "allowNetworkStatus": true
            },
            "kioskLauncherConfiguration": {
                "displayDeviceName": true,
                "settingAction": "GLOBAL",
                "whitelistedApps": [
                    "com.company.app1",
                    "com.company.app2"
                ],
                "escapeHatchPassword": "",
                "backgroundUrl": "https://cdn.company.com/wallpaper.jpg",
                "iconSize": "medium",
                "screenAlwaysOn": true,
                "unlockPassword": "",
                "inactivityLockTime": 300,
                "startingUpApps": [
                    {
                        "packageName": "com.company.dashboard",
                        "config": {}
                    }
                ],
                "appsLayout": [
                    {
                        "type": "app",
                        "package": "com.company.app1"
                    }
                ],
                "header": {
                    "text": "Company Name",
                    "fontSize": "large"
                },
                "footer": {
                    "text": "Support: [email protected]",
                    "fontSize": "small"
                }
            },
            "certificateProviderIds": [
                "698f42e5457fafa13d088797",
                "698f42e5457fafa13d088798"
            ],
            "applications": [
                {
                    "emmApplicationId": "string",
                    "configuration": "string",
                    "action": "forceInstall",
                    "updatePolicy": {},
                    "customAppConfig": {}
                }
            ],
            "applicationsInfo": [
                {
                    "emmApplicationId": "698f42e5457fafa13d088799",
                    "emmApplication": {}
                }
            ],
            "segmentId": 1
        },
        "emmPolicy": {
            "id": "string",
            "name": "string",
            "version": "string"
        },
        "emmPolicyAssignments": [
            {
                "emmPolicyId": "698f42e5457fafa13d08879f",
                "emmPolicy": {},
                "priority": 1
            }
        ],
        "emmPolicyAssignmentsEnforced": [
            {
                "emmPolicyId": "698f42e5457fafa13d08879f",
                "emmPolicy": {},
                "priority": 1,
                "automationRule": {
                    "id": "698f42e5457fafa13d08879d",
                    "name": "Sales Team iOS Policies",
                    "deviceAudiences": [
                        {
                            "id": "698f42e5457fafa13d0887a7",
                            "name": "Sales Department",
                            "reasons": [
                                "tag:sales",
                                "user.department:Sales"
                            ]
                        }
                    ]
                }
            }
        ],
        "state": "ACTIVE",
        "displayName": "string",
        "tags": [
            "string"
        ],
        "hasApplications": true,
        "config": {
            "apiLevel": 0,
            "appliedPolicyVersion": "string",
            "appliedState": "ACTIVE",
            "disabledReason": {
                "localizedMessages": {},
                "defaultMessage": "string"
            },
            "enrollmentTime": "2024-01-01T00: 00:00Z",
            "displays": [
                {
                    "name": "string",
                    "displayId": 0,
                    "refreshRate": 0,
                    "state": "DISPLAY_STATE_UNSPECIFIED",
                    "width": 0,
                    "height": 0,
                    "density": 0
                }
            ],
            "applicationReports": "string",
            "hardwareInfo": {
                "brand": "string",
                "hardware": "string",
                "deviceBasebandVersion": "string",
                "manufacturer": "string",
                "serialNumber": "string",
                "model": "string",
                "batteryShutdownTemperatures": [
                    "string"
                ],
                "batteryThrottlingTemperatures": [
                    "string"
                ],
                "cpuShutdownTemperatures": [
                    "string"
                ],
                "cpuThrottlingTemperatures": [
                    "string"
                ],
                "gpuShutdownTemperatures": [
                    "string"
                ],
                "gpuThrottlingTemperatures": [
                    "string"
                ],
                "skinShutdownTemperatures": [
                    "string"
                ],
                "skinThrottlingTemperatures": [
                    "string"
                ]
            },
            "lastPolicySyncTime": "2024-01-01T00: 00:00Z",
            "lastStatusReportTime": "2024-01-01T00: 00:00Z",
            "managementMode": "MANAGEMENT_MODE_UNSPECIFIED",
            "memoryInfo": {
                "totalInternalStorage": "string",
                "totalRam": "string"
            },
            "memoryEvents": [
                {
                    "eventType": "MEMORY_EVENT_TYPE_UNSPECIFIED",
                    "createTime": "string",
                    "byteCount": "string"
                }
            ],
            "powerManagementEvents": [
                {
                    "eventType": "POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED",
                    "createTime": "string",
                    "batteryLevel": 0
                }
            ],
            "hardwareStatusSamples": {
                "createTime": "string",
                "batteryTemperatures": [
                    0
                ],
                "cpuTemperatures": [
                    0
                ],
                "gpuTemperatures": [
                    0
                ],
                "skinTemperatures": [
                    0
                ],
                "fanSpeeds": [
                    0
                ],
                "cpuUsages": [
                    0
                ]
            },
            "networkInfo": {
                "imei": "string",
                "meid": "string",
                "wifiMacAddress": "string",
                "networkOperatorName": "string",
                "telephonyInfos": [
                    {
                        "phoneNumber": "string",
                        "carrierName": "string"
                    }
                ]
            },
            "deviceSettings": {
                "isDeviceSecure": true,
                "unknownSourcesEnabled": true,
                "developmentSettingsEnabled": true,
                "adbEnabled": true,
                "isEncrypted": true,
                "encryptionStatus": "ENCRYPTION_STATUS_UNSPECIFIED",
                "verifyAppsEnabled": true
            },
            "policyCompliant": true,
            "previousDeviceNames": [
                "string"
            ],
            "securityPosture": {
                "devicePosture": "SECURE",
                "postureDetails": [
                    {
                        "securityRisk": "SECURITY_RISK_UNSPECIFIED",
                        "advice": {
                            "localizedMessages": {}
                        }
                    }
                ]
            },
            "softwareInfo": {
                "androidBuildNumber": "string",
                "androidBuildTime": "2024-01-01T00: 00:00Z",
                "androidDevicePolicyVersionCode": 0,
                "androidDevicePolicyVersionName": "string",
                "androidVersion": "string",
                "bootloaderVersion": "string",
                "deviceBuildSignature": "string",
                "deviceKernelVersion": "string",
                "primaryLanguageCode": "string",
                "securityPatchLevel": "string",
                "systemUpdateInfo": {
                    "updateStatus": "UPDATE_STATUS_UNKNOWN",
                    "updateReceivedTime": "2024-01-01T00: 00:00Z"
                }
            },
            "systemProperties": "string",
            "ownership": "OWNERSHIP_UNSPECIFIED",
            "state": "ACTIVE",
            "nonComplianceDetails": [
                {
                    "settingName": "string",
                    "nonComplianceReason": "API_LEVEL",
                    "packageName": "string",
                    "installationFailureReason": "INSTALLATION_FAILURE_REASON_UNKNOWN",
                    "fieldPath": "string"
                }
            ],
            "commonCriteriaModeInfo": {
                "commonCriteriaModeStatus": "COMMON_CRITERIA_MODE_STATUS_UNKNOWN"
            },
            "certificateReport": [
                {
                    "origin": "mdmAsset",
                    "originId": "string",
                    "state": "installed",
                    "errorCode": "string",
                    "errorMessage": "string",
                    "updatedAt": "2024-01-01T00: 00:00Z",
                    "challenge": "string",
                    "keyPairAlias": "string",
                    "commonName": "string",
                    "isIdentity": true,
                    "certificateInfo": {
                        "issuer": "string",
                        "serialNumber": "string",
                        "subject": "string",
                        "subjectAltName": "string",
                        "validFrom": "2024-01-01T00: 00:00Z",
                        "validTo": "2024-01-01T00: 00:00Z"
                    }
                }
            ]
        },
        "_config": {},
        "summary": {
            "name": "string",
            "osVersion": "string",
            "managementMode": "DEVICE_OWNER",
            "imei": "string",
            "battery": "string",
            "os": "string",
            "serialNumber": "string",
            "image": "string",
            "compliance": {},
            "manufacturer": "string",
            "model": "string",
            "udid": "string",
            "hostname": "string",
            "ipAddress": "string",
            "macAddress": "string"
        },
        "type": "string",
        "subType": "string",
        "lastLocation": {
            "agent": {
                "origin": "agent",
                "date": "2024-01-01T00: 00:00Z",
                "latitude": 0,
                "longitude": 0,
                "ip": "string",
                "lastReportDate": "2024-01-01T00: 00:00Z",
                "address": {
                    "address": "string",
                    "number": "string",
                    "postalCode": "string",
                    "city": "string",
                    "country": "string"
                }
            },
            "ip": {
                "origin": "agent",
                "date": "2024-01-01T00: 00:00Z",
                "latitude": 0,
                "longitude": 0,
                "ip": "string",
                "lastReportDate": "2024-01-01T00: 00:00Z",
                "address": {
                    "address": "string",
                    "number": "string",
                    "postalCode": "string",
                    "city": "string",
                    "country": "string"
                }
            }
        },
        "lastStatusReportTime": "2024-01-01T00: 00:00Z",
        "stateHistory": [
            {
                "state": "ACTIVE",
                "date": "2024-01-01T00: 00:00Z",
                "config": {}
            }
        ],
        "lastReports": {
            "sync": "2024-01-01T00: 00:00Z",
            "agent": {
                "location": "2024-01-01T00: 00:00Z",
                "packageTime": "2024-01-01T00: 00:00Z",
                "packageTransfer": "2024-01-01T00: 00:00Z"
            }
        },
        "lostMode": {
            "enabled": true,
            "startDate": "2024-01-01T00: 00:00Z",
            "endDate": "2024-01-01T00: 00:00Z",
            "stoppedBy": "admin",
            "lastLocation": {
                "latitude": 0,
                "longitude": 0,
                "batteryLevel": 0
            }
        },
        "certificateReport": [
            {
                "origin": "mdmAsset",
                "originId": "string",
                "state": "installed",
                "errorCode": "string",
                "errorMessage": "string",
                "updatedAt": "2024-01-01T00: 00:00Z",
                "challenge": "string",
                "keyPairAlias": "string",
                "commonName": "string",
                "data": "string",
                "isIdentity": true,
                "certificateInfo": {
                    "issuer": "string",
                    "serialNumber": "string",
                    "subject": "string",
                    "subjectAltName": "string",
                    "validFrom": "2024-01-01T00: 00:00Z",
                    "validTo": "2024-01-01T00: 00:00Z"
                }
            }
        ],
        "enrolledDate": "2024-01-01T00: 00:00Z",
        "pushNotifications": {
            "mdmAgent": true,
            "remoteSupport": true,
            "kioskLauncher": true
        },
        "updatedAt": "2024-01-01T00: 00:00Z",
        "createdAt": "2024-01-01T00: 00:00Z",
        "segmentId": 0,
        "devicePolicyStatus": {
            "pushed": true,
            "audit": {
                "name": "string",
                "config": {
                    "version": "string"
                },
                "device": {
                    "version": "string"
                }
            }
        }
    }
}
400 Response application/json
status boolean optional
false
error object optional
code number optional
5095
message string optional
Error From Emm Android Library
{
    "status": false,
    "error": {
        "code": 5050,
        "message": "Feature not allowed for you billing plan"
    }
}
401 Response application/json
status boolean optional
false
error object optional
code number optional
4004
message string optional
Invalid Token
{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}
404 Response application/json
status boolean optional
false
error object optional
code number optional
3001
message string optional
Entity not found
{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}