Files

Add a file to MDM for usage in other API.

End Points

POST

/api/v1/mdm/files

Attribute

content_type

string

Content Type :

File Extension	Platform	Content type
apk	Android	application/vnd.android.package-archive
ipa	iOS	application/x-itunes-ipa
appxbundle	Windows	application/zip
xap	Windows	application/zip
appx	Windows	application/zip
msi	Windows	application/x-ms-installer
msix	Windows	application/zip

file_name

string

Name of File

file_id

long

Unique Identifier for the file

expiry_time

long

Timestamp until when the file is valid

content_length

integer

Length of the file (in bytes)

{
    "content_type": "image/png",
    "file_name": "check.png",
    "file_id": 123124,
    "expiry_time": 15987913528,
    "content_length": 1479
}

Upload a file to MDM Deprecated

⚠️ Deprecation Notice: /api/v1/mdm/files is deprecated as of On-Premises build 11.2.2509.XX.Use /emsapi/files for new implementations and migrate existing usage to this endpoint before it is completely removed.

Upload a file
oauthscope : MDMOnDemand.MDMDeviceMgmt.CREATE

POST - /api/v1/mdm/files

Content-Disposition

string

(Required)

Name of file with extension

Arguments

stream

bytestream

(Required)

bytestream of the file

Request Example

import http.client

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

file_path = "path/to/your_file/file_name"
file_name = "file_name"

with open(file_path, "rb") as file:
    file_data = file.read()

payload = file_data

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

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

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

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

OkHttpClient client = new OkHttpClient();

File file = new File("path/to/your_file/file_name");
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, file);
Request request = new Request.Builder()
  .url("https://www.mdm.manageengine.ca/api/v1/mdm/files")
  .post(body)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .addHeader("content-type", "application/json")
  .addHeader("content-disposition", "filename=file_name.extension")
  .build();

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

curl --request POST \
  --url https://www.mdm.manageengine.ca/api/v1/mdm/files \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --header 'content-disposition: filename=fileName.extension' \
  --data-binary '@location_to_your_file'

HTTP/1.1 200 Create

{
    "content_type": "image/png",
    "file_name": "check.png",
    "file_id": 123124,
    "expiry_time": 15987913528,
    "content_length": 1479
}

Upload a File to MDM Using Module Configuration Recommended

✅ Recommended API: This is the recommended API for file uploads starting from On-Premises build 11.2.2509.XX. It replaces the deprecated /api/v1/mdm/files API and provides enhanced functionality with module configuration support. For file upload-related queries, please contact support.

Upload file to the server using module configuration. Supported file types include images, audios, videos, certificates and many more.
oauthscope : MDMOnDemand.MDMDeviceMgmt.CREATE

POST - /emsapi/files

Module

string

(Required)

Specifies the module configuration where the uploaded file will be used.
Example: MDM_PROFILES_IMAGES - used for images in profile creation and modification.
Below are some commonly used modules. Additional module configurations are documented in their respective API references.

Module Name	Description	Supported File Types
MDM_CERTIFICATES	Upload security certificates for device authentication and encryption	.cer, .crt, .pem, .pfx, .p12
MDM_APP_MGMT	Upload application packages for distribution to managed devices	.apk, .ipa, .xap, .msix, .msixbundle, .appx, .appxbundle, .pkg
MDM_CUSTOM_PROFILE	Upload custom configuration profiles for advanced device settings	.xml, .mobileconfig, .plist, .json
MDM_CONTENT_MGMT	Upload content files for distribution to devices (documents, media, etc.)	Various file types
MDM_APP_REPOSITORY_CUSTOM_CONFIG	Upload custom app configuration files for managed application settings	.xml, .plist

Request Body

In that Multipart-from request the key should be "file" and the value should be the file content(binary).

Request Example

import http.client
import mimetypes
import uuid
import os

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

file_path = "path/to/your_file/file_name"
file_name = os.path.basename(file_path)

with open(file_path, "rb") as file:
    file_data = file.read()

boundary = str(uuid.uuid4())

multipart_data = f"--{boundary}\r\n"
    f'Content-Disposition: form-data; name="fileName"; filename="{file_name}"\r\n'
    f"Content-Type: {mimetypes.guess_type(file_name)[0] or 'application/octet-stream'}\r\n" 
    f"\r\n"
).encode("utf-8") + file_data + f"\r\n--{boundary}--\r\n".encode("utf-8")

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

conn.request("POST", "/emsapi/files", payload, body=multipart_data, headers=headers)

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

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

OkHttpClient client = new OkHttpClient();

File file = new File("path/to/your_file/file_name");
MediaType mediaType = MediaType.parse("application/json");
RequestBody fileBody = RequestBody.create(mediaType, file);
RequestBody multipartBody  = MultipartBody.Builder()
  .setType(MultipartBody.FORM)
  .addFormDataPart("fileName", file.getName(), fileBody)
  .build();

Request request = new Request.Builder()
  .url("https://www.mdm.manageengine.ca/emsapi/files")
  .post(multipartBody)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .addHeader("content-type", "application/json")
  .addHeader("module", "MDM_PROFILES_IMAGES")
  .addHeader("X-Customer", "1")
  .build();

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

curl --request POST \
  --url https://www.mdm.manageengine.ca/emsapi/files \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --header 'module: MDM_PROFILES_IMAGES' \
  --header 'X-Customer: 1' \
  --form 'fileName=@/path/to/your/file.ext'

HTTP/1.1 200 Create

{
    "fileID": "1",
    "fileName": "filename.ext",
    "customerID": "1",
    "expiryDate": "Jun 28, 2025 04:18 PM",
    "fileStatus": 2
}