Blocklist apps

[
    {
        "identifier": "com.manageengine.mdm.android",
        "appgroupid": 123123213,
        "platform": 1,
        "appname": "Manageengine MDM"
    }
]

Get the apps available for blocklisting

Apps available for blocklisting in the Inventory
oauthscope : MDMOnDemand.MDMDeviceMgmt.GET

GET - /api/v1/mdm/blacklist/apps

import http.client

conn = http.client.HTTPSConnection("www.mdm.manageengine.ca")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("GET", "/api/v1/mdm/blacklist/apps", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.mdm.manageengine.ca/api/v1/mdm/blacklist/apps")
  .get()
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

curl --request GET \
  --url https://www.mdm.manageengine.ca/api/v1/mdm/blacklist/apps \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

HTTP/1.1 200 Read

{
    "apps": [
        {
            "identifier": "com.manageengine.mdm.android",
            "appgroupid": 123123213,
            "platform": 1,
            "appname": "Manageengine MDM"
        }
    ]
}

Add a new app to be blocklisted

Add a new app to the repository to be blocklisted
oauthscope : MDMOnDemand.MDMDeviceMgmt.CREATE

POST - /api/v1/mdm/blacklist/apps

Arguments

apps

array

(Required)

List of apps

Show Sub-Attributes

identifier

string

Identifier of the app

platform

integer

App Platform: One of

ios
android
windows

appname

string

Name of the app

import http.client

conn = http.client.HTTPSConnection("www.mdm.manageengine.ca")

payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"

headers = {
    'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
    'content-type': "application/json"
    }

conn.request("POST", "/api/v1/mdm/blacklist/apps", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
  .url("https://www.mdm.manageengine.ca/api/v1/mdm/blacklist/apps")
  .post(body)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

curl --request POST \
  --url https://www.mdm.manageengine.ca/api/v1/mdm/blacklist/apps \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'

{
    "apps": [
        {
            "identifier": "com.manageengine.mdm.android",
            "platform": 1,
            "appname": "Manageengine MDM"
        }
    ]
}

HTTP/1.1 200 Create

{
    "apps": [
        {
            "identifier": "com.manageengine.mdm.android",
            "appgroupid": 123123213,
            "platform": 1,
            "appname": "Manageengine MDM"
        }
    ]
}

Blocklist apps on devices

Blocklist apps on devices managed by MDM
oauthscope : MDMOnDemand.MDMDeviceMgmt.CREATE

POST - /api/v1/mdm/blacklist/devices

Arguments

resource_ids

array

(Required)

List of resource IDs

app_group_ids

array

(Required)

List of app group IDs

import http.client

conn = http.client.HTTPSConnection("www.mdm.manageengine.ca")

payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"

headers = {
    'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
    'content-type': "application/json"
    }

conn.request("POST", "/api/v1/mdm/blacklist/devices", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
  .url("https://www.mdm.manageengine.ca/api/v1/mdm/blacklist/devices")
  .post(body)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

curl --request POST \
  --url https://www.mdm.manageengine.ca/api/v1/mdm/blacklist/devices \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'

{
    "resource_ids": [
        1,
        2,
        3
    ],
    "app_group_ids": [
        1,
        2,
        3
    ]
}

HTTP/1.1 200 Create

{
    "resource_ids": [
        1,
        2,
        3
    ]
}

Remove blocklisted apps from devices

Remove blocklisted apps from devices managed by MDM
oauthscope : MDMOnDemand.MDMDeviceMgmt.DELETE

DELETE - /api/v1/mdm/blacklist/devices

Arguments

resource_ids

array

(Required)

List of resource IDs

app_group_ids

array

(Required)

List of app group IDs

import http.client

conn = http.client.HTTPSConnection("www.mdm.manageengine.ca")

payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"

headers = {
    'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
    'content-type': "application/json"
    }

conn.request("DELETE", "/api/v1/mdm/blacklist/devices", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
  .url("https://www.mdm.manageengine.ca/api/v1/mdm/blacklist/devices")
  .delete(body)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

curl --request DELETE \
  --url https://www.mdm.manageengine.ca/api/v1/mdm/blacklist/devices \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'

{
    "resource_ids": [
        1,
        2,
        3
    ],
    "app_group_ids": [
        1,
        2,
        3
    ]
}

HTTP/1.1 200 Create

{
    "resource_ids": [
        1,
        2,
        3
    ]
}

Blocklist apps from Groups

Blocklist apps from Groups containing devices managed by MDM
oauthscope : MDMOnDemand.MDMDeviceMgmt.CREATE

POST - /api/v1/mdm/blacklist/groups

Arguments

resource_ids

array

(Required)

List of resource IDs

app_group_ids

array

(Required)

List of app group IDs

import http.client

conn = http.client.HTTPSConnection("www.mdm.manageengine.ca")

payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"

headers = {
    'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
    'content-type': "application/json"
    }

conn.request("POST", "/api/v1/mdm/blacklist/groups", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
  .url("https://www.mdm.manageengine.ca/api/v1/mdm/blacklist/groups")
  .post(body)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

curl --request POST \
  --url https://www.mdm.manageengine.ca/api/v1/mdm/blacklist/groups \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'

{
    "resource_ids": [
        1,
        2,
        3
    ],
    "app_group_ids": [
        1,
        2,
        3
    ]
}

HTTP/1.1 200 Create

{
    "resource_ids": [
        1,
        2,
        3
    ]
}

Remove blocklisted apps from Groups

Remove blocklisted apps from Groups
oauthscope : MDMOnDemand.MDMDeviceMgmt.DELETE

DELETE - /api/v1/mdm/blacklist/groups

Arguments

resource_ids

array

(Required)

List of resource IDs

app_group_ids

array

(Required)

List of app group IDs

import http.client

conn = http.client.HTTPSConnection("www.mdm.manageengine.ca")

payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"

headers = {
    'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
    'content-type': "application/json"
    }

conn.request("DELETE", "/api/v1/mdm/blacklist/groups", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
  .url("https://www.mdm.manageengine.ca/api/v1/mdm/blacklist/groups")
  .delete(body)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

curl --request DELETE \
  --url https://www.mdm.manageengine.ca/api/v1/mdm/blacklist/groups \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'

{
    "resource_ids": [
        1,
        2,
        3
    ],
    "app_group_ids": [
        1,
        2,
        3
    ]
}

HTTP/1.1 200 Create

{
    "resource_ids": [
        1,
        2,
        3
    ]
}

Get blocklist status

Get the status of the blocklist action on devices
oauthscope : MDMOnDemand.MDMDeviceMgmt.GET

GET - /api/v1/mdm/blacklist/status

import http.client

conn = http.client.HTTPSConnection("www.mdm.manageengine.ca")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("GET", "/api/v1/mdm/blacklist/status", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.mdm.manageengine.ca/api/v1/mdm/blacklist/status")
  .get()
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

curl --request GET \
  --url https://www.mdm.manageengine.ca/api/v1/mdm/blacklist/status \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

HTTP/1.1 200 Read

{
    "Blackliststatus": [
        {
            "status": 4,
            "resourceId": 1232131232,
            "identifier": "com.manageengine.mdm.android",
            "appname": "Manageengine MDM"
        }
    ]
}