Groups
Simplify device management by organizing devices into groups.
Attribute
- Device Group
[
{
"group_id": 99731238129,
"name": "MDM",
"group_type": 1,
"domain": "ZOHOCORP"
}
]
Get Group list
Get a list of Groups available in MDM oauthscope : MDMOnDemand.MDMDeviceMgmt.READ
GET - /api/v1/mdm/groups
import http.client
conn = http.client.HTTPSConnection("www.mdm.manageengine.eu")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("GET", "/api/v1/mdm/groups", 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.eu/api/v1/mdm/groups")
.get()
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
curl --request GET \
--url https://www.mdm.manageengine.eu/api/v1/mdm/groups \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
HTTP/1.1 200 Read{
"groups": [
{
"group_id": 99731238129,
"name": "MDM",
"group_type": 1,
"domain": "ZOHOCORP"
}
]
}
Create a Group
Create a Group for managing devices oauthscope : MDMOnDemand.MDMDeviceMgmt.CREATE
POST - /api/v1/mdm/groups
Arguments
- Device Group
import http.client
conn = http.client.HTTPSConnection("www.mdm.manageengine.eu")
payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"
headers = {
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
'content-type': "application/json"
}
conn.request("POST", "/api/v1/mdm/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.eu/api/v1/mdm/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.eu/api/v1/mdm/groups \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"field1":"value1","field2":"value2"}'
{
"name": "MDM",
"group_type": 1,
"domain": "ZOHOCORP",
"description": "Group for MDM"
}
HTTP/1.1 200 Create{
"group_id": 99731238129,
"name": "MDM",
"group_type": 1,
"domain": "ZOHOCORP",
"description": "Group for MDM"
}
Get Group details
Get details of a particular Group available in MDM oauthscope : MDMOnDemand.MDMDeviceMgmt.READ
GET - /api/v1/mdm/groups/{group_id}
Query Parameters
- To Include the members details use memberdetails (OR)
- To Include the members IDs use member (OR)
- To Include the group summary details use summary
import http.client
conn = http.client.HTTPSConnection("www.mdm.manageengine.eu")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("GET", "/api/v1/mdm/groups/99731238129", 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.eu/api/v1/mdm/groups/99731238129")
.get()
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
curl --request GET \
--url https://www.mdm.manageengine.eu/api/v1/mdm/groups/99731238129 \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
HTTP/1.1 200 Read{
"group_id": 99731238129,
"name": "MDM",
"group_type": 1,
"domain": "ZOHOCORP",
"description": "Group for MDM"
}
Delete an existing Group
Delete a Group available in MDMoauthscope : MDMOnDemand.MDMDeviceMgmt.DELETE
DELETE - /api/v1/mdm/groups/{group_id}
import http.client
conn = http.client.HTTPSConnection("www.mdm.manageengine.eu")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("DELETE", "/api/v1/mdm/groups/99731238129", 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.eu/api/v1/mdm/groups/99731238129")
.delete(null)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
curl --request DELETE \
--url https://www.mdm.manageengine.eu/api/v1/mdm/groups/99731238129 \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
HTTP/1.1 204 No Content
Get members present in a Group
Get a list of members present in a particular Group oauthscope : MDMOnDemand.MDMDeviceMgmt.READ
GET - /api/v1/mdm/groups/{group_id}/members
Query Parameters
- memberdetails
import http.client
conn = http.client.HTTPSConnection("www.mdm.manageengine.eu")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("GET", "/api/v1/mdm/groups/99731238129/members", 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.eu/api/v1/mdm/groups/99731238129/members")
.get()
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
curl --request GET \
--url https://www.mdm.manageengine.eu/api/v1/mdm/groups/99731238129/members \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
HTTP/1.1 200 Read{
"member_ids": [
12,
213123,
21312
]
}
Add members to a Group
Add multiple members simultaneously to an existing Group oauthscope : MDMOnDemand.MDMDeviceMgmt.CREATE
POST - /api/v1/mdm/groups/{group_id}/members
Arguments
import http.client
conn = http.client.HTTPSConnection("www.mdm.manageengine.eu")
payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"
headers = {
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
'content-type': "application/json"
}
conn.request("POST", "/api/v1/mdm/groups/99731238129/members", 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.eu/api/v1/mdm/groups/99731238129/members")
.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.eu/api/v1/mdm/groups/99731238129/members \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"field1":"value1","field2":"value2"}'
{
"member_ids": [
12,
213123,
21312
]
}
HTTP/1.1 200 Create{
"member_ids": [
12,
213123,
21312
]
}
Add a member to a Group
Add a particular member to a selected Group oauthscope : MDMOnDemand.MDMDeviceMgmt.CREATE
POST - /api/v1/mdm/groups/{group_id}/members/{member_id}
import http.client
conn = http.client.HTTPSConnection("www.mdm.manageengine.eu")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("POST", "/api/v1/mdm/groups/99731238129/members/987000000654321", 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.eu/api/v1/mdm/groups/99731238129/members/987000000654321")
.post(null)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
curl --request POST \
--url https://www.mdm.manageengine.eu/api/v1/mdm/groups/99731238129/members/987000000654321 \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
HTTP/1.1 202 Accepted
Remove a member from a Group
Remove a member from a particular Group oauthscope : MDMOnDemand.MDMDeviceMgmt.DELETE
DELETE - /api/v1/mdm/groups/{group_id}/members/{member_id}
import http.client
conn = http.client.HTTPSConnection("www.mdm.manageengine.eu")
headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }
conn.request("DELETE", "/api/v1/mdm/groups/99731238129/members/987000000654321", 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.eu/api/v1/mdm/groups/99731238129/members/987000000654321")
.delete(null)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.build();
Response response = client.newCall(request).execute();
curl --request DELETE \
--url https://www.mdm.manageengine.eu/api/v1/mdm/groups/99731238129/members/987000000654321 \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
HTTP/1.1 204 No Content
Associate apps to a Group
Associate apps to a Group in MDMoauthscope : MDMOnDemand.MDMDeviceMgmt.CREATE
POST - /api/v1/mdm/groups/{group_id}/apps
Arguments
import http.client
conn = http.client.HTTPSConnection("www.mdm.manageengine.eu")
payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"
headers = {
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
'content-type': "application/json"
}
conn.request("POST", "/api/v1/mdm/groups/99731238129/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.eu/api/v1/mdm/groups/99731238129/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.eu/api/v1/mdm/groups/99731238129/apps \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"field1":"value1","field2":"value2"}'
{
"app_details": [
{
"app_id": 12,
"release_label_id": 123
}
],
"silent_install": true,
"notify_user_via_email": true
}
HTTP/1.1 200 Accepted
Disassociate apps from a Group
Disassociate apps from a Group in MDM oauthscope : MDMOnDemand.MDMDeviceMgmt.DELETE
DELETE - /api/v1/mdm/groups/{group_id}/apps
Arguments
import http.client
conn = http.client.HTTPSConnection("www.mdm.manageengine.eu")
payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"
headers = {
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
'content-type': "application/json"
}
conn.request("DELETE", "/api/v1/mdm/groups/99731238129/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.eu/api/v1/mdm/groups/99731238129/apps")
.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.eu/api/v1/mdm/groups/99731238129/apps \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"field1":"value1","field2":"value2"}'
{
"app_ids": [
1,
2,
3
]
}
HTTP/1.1 200 No Content
Associate profiles to a Group
Associate profiles to a Group in MDM oauthscope : MDMOnDemand.MDMDeviceMgmt.CREATE
POST - /api/v1/mdm/groups/{group_id}/profiles
Arguments
import http.client
conn = http.client.HTTPSConnection("www.mdm.manageengine.eu")
payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"
headers = {
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
'content-type': "application/json"
}
conn.request("POST", "/api/v1/mdm/groups/99731238129/profiles", 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.eu/api/v1/mdm/groups/99731238129/profiles")
.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.eu/api/v1/mdm/groups/99731238129/profiles \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"field1":"value1","field2":"value2"}'
{
"profile_ids": [
1,
2,
3
]
}
HTTP/1.1 200 Accepted
Disassociate profiles from a Group in MDM
Disassociate profiles from a Group in MDM oauthscope : MDMOnDemand.MDMDeviceMgmt.DELETE
DELETE - /api/v1/mdm/groups/{group_id}/profiles
Arguments
import http.client
conn = http.client.HTTPSConnection("www.mdm.manageengine.eu")
payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"
headers = {
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
'content-type': "application/json"
}
conn.request("DELETE", "/api/v1/mdm/groups/99731238129/profiles", 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.eu/api/v1/mdm/groups/99731238129/profiles")
.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.eu/api/v1/mdm/groups/99731238129/profiles \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"field1":"value1","field2":"value2"}'
{
"profile_ids": [
1,
2,
3
]
}
HTTP/1.1 200 No Content
Move devices from one group to other groups
Move a set of member from one group to other Groups oauthscope : MDMOnDemand.MDMDeviceMgmt.CREATE
PUT - /api/v1/mdm/groups/{group_id}/targetgroups
Arguments
import http.client
conn = http.client.HTTPSConnection("www.mdm.manageengine.eu")
payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"
headers = {
'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
'content-type': "application/json"
}
conn.request("PUT", "/api/v1/mdm/groups/99731238129/targetgroups", 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.eu/api/v1/mdm/groups/99731238129/targetgroups")
.put(body)
.addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
.addHeader("content-type", "application/json")
.build();
Response response = client.newCall(request).execute();
curl --request PUT \
--url https://www.mdm.manageengine.eu/api/v1/mdm/groups/99731238129/targetgroups \
--header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
--header 'content-type: application/json' \
--data '{"field1":"value1","field2":"value2"}'
{
"member_ids": [
12,
213123,
21312
],
"target_group_ids": [
1,
2,
3
]
}
HTTP/1.1 200 Success{
"success": true
}