PUT
https://api.applivery.io/v1/organizations/{organizationId}/mdm/android/enterprise/devices/{emmDeviceId}
curl -X PUT "https://api.applivery.io/v1/organizations/{organizationId}/mdm/android/enterprise/devices/{emmDeviceId}" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"displayName": "string",
"tags": [
"string"
],
"state": "ACTIVE",
"disabledReason": "string",
"policyId": "string",
"emmPolicyAssignments": [
{}
],
"mdmUserId": "string",
"smartAttributeAssignments": [
{}
],
"segmentId": 0
}'const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/mdm/android/enterprise/devices/{emmDeviceId}", {
method: "PUT",
headers: {
Authorization: "Bearer <YOUR_API_KEY>",
"Content-Type": "application/json",
},
body: JSON.stringify({
"displayName": "string",
"tags": [
"string"
],
"state": "ACTIVE",
"disabledReason": "string",
"policyId": "string",
"emmPolicyAssignments": [
{}
],
"mdmUserId": "string",
"smartAttributeAssignments": [
{}
],
"segmentId": 0
}),
});
const data = await response.json();import requests
response = requests.put(
"https://api.applivery.io/v1/organizations/{organizationId}/mdm/android/enterprise/devices/{emmDeviceId}",
headers={"Authorization": "Bearer <YOUR_API_KEY>"},
json={
"displayName": "string",
"tags": [
"string"
],
"state": "ACTIVE",
"disabledReason": "string",
"policyId": "string",
"emmPolicyAssignments": [
{}
],
"mdmUserId": "string",
"smartAttributeAssignments": [
{}
],
"segmentId": 0
},
)
data = response.json()Request
Send your API key in the request header
authorization
Example:
Authorization: Bearer <token>
organizationId
string
required
emmDeviceId
string
required
Body Params
application/json
displayName
string
optional
tags
array [string]
optional
state
string
optional
disabledReason
string
optional
policyId
string
optional
emmPolicyAssignments
array [object]
optional
emmPolicyId
string
optional
priority
integer
required
mdmUserId
string
optional
smartAttributeAssignments
array [object]
optional
smartAttributeId
string
required
segmentId
number
optional
{
"displayName": "string",
"tags": [
"string"
],
"state": "ACTIVE",
"disabledReason": "string",
"policyId": "string",
"emmPolicyAssignments": [
{
"emmPolicyId": "string",
"priority": 0
}
],
"mdmUserId": "string",
"smartAttributeAssignments": [
{
"smartAttributeId": "string"
}
],
"segmentId": 0
}
Responses
200 Response
application/json
status
boolean
optional
data
object
optional
id
string
optional
organization
string
optional
emmEnterprise
string
optional
mdmUser
object
optional
id
string
optional
email
string
optional
deviceEmmPolicy
object
optional
id
string
optional
name
string
optional
description
string
optional
version
string
optional
config
object
optional
_config
object
optional
packages
object
optional
emmEnterprise
string
optional
private
boolean
optional
assets
array [object]
optional
assetsInfo
array [object]
optional
bookmarks
array [object]
optional
updatedAt
string
optional
createdAt
string
optional
agentConfiguration
object
optional
kioskLauncherConfiguration
object
optional
certificateProviderIds
array [string]
optional
certificateProviderAssignments
array [object]
optional
applications
array [object]
optional
applicationsInfo
array [object]
optional
segmentId
integer
optional
exposeToChildren
boolean
optional
appliedEmmPolicy
object
optional
id
string
optional
name
string
optional
description
string
optional
version
string
optional
config
object
optional
_config
object
optional
packages
object
optional
emmEnterprise
string
optional
private
boolean
optional
assets
array [object]
optional
assetsInfo
array [object]
optional
bookmarks
array [object]
optional
updatedAt
string
optional
createdAt
string
optional
agentConfiguration
object
optional
kioskLauncherConfiguration
object
optional
certificateProviderIds
array [string]
optional
certificateProviderAssignments
array [object]
optional
applications
array [object]
optional
applicationsInfo
array [object]
optional
segmentId
integer
optional
exposeToChildren
boolean
optional
emmPolicy
object
optional
id
string
optional
name
string
optional
version
string
optional
emmPolicyAssignments
array [object]
optional
emmPolicyId
string
optional
emmPolicy
object
optional
priority
integer
optional
emmPolicyAssignmentsEnforced
array [object]
optional
emmPolicyId
string
optional
emmPolicy
object
optional
priority
integer
optional
automationRule
object
optional
state
string
optional
displayName
string
optional
tags
array [string]
optional
hasApplications
boolean
optional
config
object
optional
apiLevel
integer
optional
appliedPolicyVersion
string
optional
appliedState
string
optional
disabledReason
object
optional
enrollmentTime
string
optional
displays
array [object]
optional
applicationReports
string
optional
hardwareInfo
object
optional
lastPolicySyncTime
string
optional
lastStatusReportTime
string
optional
managementMode
string
optional
memoryInfo
object
optional
memoryEvents
array [object]
optional
powerManagementEvents
array [object]
optional
hardwareStatusSamples
object
optional
networkInfo
object
optional
deviceSettings
object
optional
policyCompliant
boolean
optional
previousDeviceNames
array [string]
optional
securityPosture
object
optional
softwareInfo
object
optional
systemProperties
string
optional
ownership
string
optional
state
string
optional
nonComplianceDetails
array [object]
optional
commonCriteriaModeInfo
object
optional
certificateReport
array [object]
optional
_config
object
optional
summary
object
optional
name
string
optional
osVersion
string
optional
managementMode
string
optional
imei
string
optional
battery
string
optional
os
string
optional
serialNumber
string
optional
image
string
optional
compliance
object
optional
manufacturer
string
optional
model
string
optional
udid
string
optional
hostname
string
optional
ipAddress
string
optional
macAddress
string
optional
smartAttributeAssignments
array [object]
optional
smartAttributeId
string
optional
smartAttribute
object
optional
smartAttributeAssignmentsEnforced
array [object]
optional
smartAttributeId
string
optional
smartAttribute
object
optional
smartAttributes
array [object]
optional
id
string
required
type
string
optional
label
string
optional
value
string
required
updatedAt
string
required
type
string
optional
subType
string
optional
lastLocation
object
optional
agent
object
optional
ip
object
optional
lastStatusReportTime
string
optional
stateHistory
array [object]
optional
state
string
optional
date
string
optional
config
object
optional
lastReports
object
optional
sync
string
optional
agent
object
optional
lostMode
object
optional
enabled
boolean
optional
startDate
string
optional
endDate
string
optional
stoppedBy
string
optional
lastLocation
object
optional
certificateReport
array [object]
optional
origin
string
optional
originId
string
optional
state
string
optional
errorCode
string
optional
errorMessage
string
optional
updatedAt
string
optional
challenge
string
optional
keyPairAlias
string
optional
commonName
string
optional
isIdentity
boolean
optional
clientIdentity
string
optional
certificateInfo
object
optional
enrolledDate
string
optional
pushNotifications
object
optional
mdmAgent
boolean
optional
remoteSupport
boolean
optional
kioskLauncher
boolean
optional
updatedAt
string
optional
createdAt
string
optional
segmentId
integer
optional
devicePolicyStatus
object
optional
pushed
boolean
optional
audit
object
optional
{
"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": [],
"bookmarks": [
{}
],
"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"
],
"certificateProviderAssignments": [
{
"certificateProviderId": "698f42e5457fafa13d088797",
"storeCredentials": false
}
],
"applications": [
{
"emmApplicationId": "string",
"configuration": "string",
"action": "forceInstall",
"updatePolicy": {},
"customAppConfig": {}
}
],
"applicationsInfo": [
{
"emmApplicationId": "698f42e5457fafa13d088799",
"emmApplication": {}
}
],
"segmentId": 1,
"exposeToChildren": true
},
"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": [],
"bookmarks": [
{}
],
"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"
],
"certificateProviderAssignments": [
{
"certificateProviderId": "698f42e5457fafa13d088797",
"storeCredentials": false
}
],
"applications": [
{
"emmApplicationId": "string",
"configuration": "string",
"action": "forceInstall",
"updatePolicy": {},
"customAppConfig": {}
}
],
"applicationsInfo": [
{
"emmApplicationId": "698f42e5457fafa13d088799",
"emmApplication": {}
}
],
"segmentId": 1,
"exposeToChildren": true
},
"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,
"clientIdentity": "string",
"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"
},
"smartAttributeAssignments": [
{
"smartAttributeId": "string",
"smartAttribute": {
"id": "string",
"organizationId": "string",
"segmentId": 0,
"exposeToChildren": true,
"name": "string",
"description": "string",
"output": {
"type": "string"
},
"input": {
"type": "constant",
"value": {
"admDevice": {
"value": "string"
},
"aosDevice": {
"value": "string"
},
"emmDevice": {
"value": "string"
},
"winDevice": {
"value": "string"
}
},
"source": "constant"
},
"counts": {
"android": {
"smartAttributeAssignments": 0,
"smartAttributeAssignmentsEnforced": 0
},
"apple": {
"smartAttributeAssignments": 0,
"smartAttributeAssignmentsEnforced": 0
},
"windows": {
"smartAttributeAssignments": 0,
"smartAttributeAssignmentsEnforced": 0
}
}
}
}
],
"smartAttributeAssignmentsEnforced": [
{
"smartAttributeId": "string",
"smartAttribute": {
"id": "string",
"organizationId": "string",
"segmentId": 0,
"exposeToChildren": true,
"name": "string",
"description": "string",
"output": {
"type": "string"
},
"input": {
"type": "constant",
"value": {
"admDevice": {
"value": "string"
},
"aosDevice": {
"value": "string"
},
"emmDevice": {
"value": "string"
},
"winDevice": {
"value": "string"
}
},
"source": "constant"
},
"counts": {
"android": {
"smartAttributeAssignments": 0,
"smartAttributeAssignmentsEnforced": 0
},
"apple": {
"smartAttributeAssignments": 0,
"smartAttributeAssignmentsEnforced": 0
},
"windows": {
"smartAttributeAssignments": 0,
"smartAttributeAssignmentsEnforced": 0
}
}
}
}
],
"smartAttributes": [
{
"id": "string",
"type": "constant",
"label": "string",
"value": "string",
"updatedAt": "2024-01-01T00: 00:00Z"
}
],
"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",
"isIdentity": true,
"clientIdentity": "string",
"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
error
object
optional
code
number
optional
message
string
optional
{
"status": false,
"error": {
"code": 5050,
"message": "Feature not allowed for you billing plan"
}
}
401 Response
application/json
status
boolean
optional
error
object
optional
code
number
optional
message
string
optional
{
"status": false,
"error": {
"code": 4002,
"message": "No auth token"
}
}
404 Response
application/json
status
boolean
optional
error
object
optional
code
number
optional
message
string
optional
{
"status": false,
"error": {
"code": 3001,
"message": "Entity not found"
}
}