Users

[
    {
        "email_address": "email_address@zylker.com",
        "user_id": 9007199254741000,
        "name": "admin",
        "phone_number": "+91-9876****99",
        "domain": "mdm"
    }
]

Get Managed Users

Get list of managed users
oauthscope : MDMOnDemand.MDMUser.READ

GET - /api/v1/mdm/users

Query Parameters

user_identifier

allowed values: name, email_id

search key of the device name / User name

search string

include

Include the aduserdetails

user_type

list of user type of the device in comma separated

id of the Group

select_all

select_all to get all values details

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

HTTP/1.1

{
    "users": [
        {
            "email_address": "email_address@zylker.com",
            "user_id": 9007199254741000,
            "name": "admin",
            "phone_number": "+91-9876****99",
            "domain": "mdm"
        }
    ],
    "metadata": {
        "total_record_count": 150
    },
    "paging": {
        "next": "http://localhost:9020/api/v1/mdm/users?skip-token=NDo1OjE6MTU2ODcyMzM5NjUwOQ%3D%3D"
    }
}

Remove Multiple Users

Remove multiple users
oauthscope : MDMOnDemand.MDMUser.CREATE

POST - /api/v1/mdm/users

Arguments

user_ids

string

(Required)

Manage the available users IDs to be removed

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

{
    "user_ids": [
        "9007199254740999",
        "9007199254756659"
    ]
}

HTTP/1.1

{
    "users": [
        {
            "email_address": "email_address@zylker.com",
            "user_id": 9007199254741000,
            "name": "admin",
            "phone_number": "+91-9876****99",
            "domain": "mdm"
        }
    ],
    "metadata": {
        "total_record_count": 150
    },
    "paging": {
        "next": "http://localhost:9020/api/v1/mdm/users?skip-token=NDo1OjE6MTU2ODcyMzM5NjUwOQ%3D%3D"
    }
}

Get User Details

Get details of a managed user
oauthscope : MDMOnDemand.MDMUser.READ

GET - /api/v1/mdm/users/{user_id}

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

HTTP/1.1

{
    "user_email": "user_email@zylker.com",
    "user_id": 9007199254741000,
    "name": "admin",
    "phone_number": "+91-9876****99",
    "device_count": 0
}

Remove User

Remove a specific user
oauthscope : MDMOnDemand.MDMUser.CREATE

POST - /api/v1/mdm/users/{user_id}

curl --request POST \
  --url https://www.mdm.manageengine.com/api/v1/mdm/users/9007199254741000 \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

HTTP/1.1

{
    "user_email": "user_email@zylker.com",
    "user_id": 9007199254741000,
    "name": "admin",
    "phone_number": "+91-9876****99",
    "device_count": 0
}

Modify User

Modify user

PUT - /api/v1/mdm/users/{user_id}

Arguments

user_email

string

(Required)

email address of the user

user_name

string

(Required)

holds name of the managed user

phone_number

string

(Required)

holds phone number of the managed user

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

{
    "user_email": "user_email@zylker.com",
    "user_name": "Mr Zylker",
    "phone_number": "+91-9876****99"
}

HTTP/1.1

{
    "user_email": "user_email@zylker.com",
    "user_id": 9007199254741000,
    "name": "admin",
    "phone_number": "+91-9876****99",
    "device_count": 0
}

Get devices for User

Get device ids for a user
oauthscope : MDMOnDemand.MDMUser.READ

GET - /api/v1/mdm/users/devices

Query Parameters

email_id

The email address of the user

domain_name

The domain name of the user

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

HTTP/1.1

{
    "device_ids": [
        "98765456789",
        "32456432136"
    ]
}