PROGET APIs facilitate integration with third-party tools, systems, and applications by respecting RESTful principles. These APIs enable you to programmatically fetch, put and edit data. All the APIs follow HTTP rules and error codes.
\nAll PROGET APIs require one mandatory field in the header.
\nPROGET APIs enable data manipulation and retrieval through different HTTP methods.
\nPROGET uses HTTP status codes to indicate the success or failure of API calls. Status codes in the 2xx range indicate success, the 4xx range suggests an error in the information provided, and the 5xx range means server-side errors. The following table lists some commonly used HTTP status codes.
\nAlways ignore undocumented fields or enum values present in the API response. These fields could be either experimental or deprecated.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"1028368","collectionId":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","publishedId":"2s93Y2SMM4","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2023-06-15T14:27:17.000Z"},"item":[{"name":"Authentication","item":[{"name":"Authentication","event":[{"listen":"test","script":{"id":"4105246c-642a-4c67-a962-33fbb9e4ceac","exec":["pm.response.to.have.status(200);","pm.expect(pm.response.json().token).not.equal(null);","pm.environment.set(\"TOKEN\", pm.response.json().token);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"2eaa9913-d349-4367-9e3d-610e7d36af8a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"username\": \"{{USER}}\",\n \"password\": \"{{PASSWORD}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/login","description":"This POST request allows you to obtain a Bearer Token. The token is sent to the backend server to access the protected resources. It provides secure and temporary access to PROGET APIs and is used by applications to make requests to the connected app.
\n","urlObject":{"protocol":"https","path":["api","mdm","login"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[{"id":"5e4eed10-249f-4921-bdfb-cc7b2c607918","name":"200 OK - Authentication token","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"username\": \"{{USER}}\",\n \"password\": \"{{PASSWORD}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/login"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Wed, 12 Apr 2023 09:23:17 GMT"},{"key":"Permissions-Policy","value":"interest-cohort=()"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"}],"cookie":[],"responseTime":null,"body":"{\n \"token\": \"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzUxMiJ9.eyJpYXQiOjE2ODEyOTEzOTcsImV4cCI6MTY4MTI5NDk5Nywicm9sZXMiOlsiUk9MRV9VU0VSIl0sImlkIjoiOGU5OTY4ZGYtYTZkNS00YmJiLWFkNWYtNmIwZjUyN2FkOTJmIiwidXNlcm5hbWUiOiJqb2huLmRvZSIsImxlZ2FjeUlkIjoxfQ.BCTbJpA_b0hU7jamGtUYxVXDihItuGeeulHyBrOtzAqkBXoWshnUSSP19fLuR9K9-nXsLSIKnbJx4-plz3D-SH55p4fRwQLKoGOHxShQZSNbxcENOeLIrJ1r0Ka_Dk64aNG68S0tnNlYLmss0V1CQEw0PEbiMGkFoJPYoop9Im0pNg_pzNwffSvFqo622LQx5DXssCJ53_XwPXDPZOhe6u-nKoo0AFQAg0Ym5WHhhoUZXj39jj_RhCbBMKj8xrkCKjgBAoA6gqiUr__Mq1eg3eLWbo-MD5zXcd1JJG6OOXKWyuaeZ5dHaguvW3VkiRCvQKjEz8ijh73nWuQ3NtVQJMevUfOLzpboXxhP5vBK5Hw7tcqz4xDcJ_ZvoY6M4_xf5mQaWGSgB3y5UZFmC2Ob_FPhFodcCJ8hGArY25CAkTH8oeFEeq2lpsm3g1BFAyJd-ew8U16vb4ezjw7R1vhXH9fK-W_XcRlRkW8z4tQw35hl_LTRQpeEOxmJnw9aNfJKHunuDgQsDQKOcNWNXmyF7zzGLLqUqm_ceQ-TsqMWjMP06p5YiCqTfFT7B5cipuIX_A08jk99OFMfn9Aiir0SH0pCBGlJD5omxFlojL-rqqvu-IYL4B1SMO_Goo2hyfKIUy7DAsdHQ7ug_two3cHOo7WVvA5tO9j4YlAkfpH-MsQ\",\n \"permissions\": [],\n \"eulaConfirmed\": true,\n \"passwordChanged\": true,\n \"defaultTenantAlias\": \"example\",\n \"chatEnabled\": false,\n \"superAdmin\": true,\n \"lastLoginAt\": {\n \"positive\": \"2023-01-01 12:00:00\",\n \"negative\": \"2023-01-01 11:00:00\"\n }\n}"}],"_postman_id":"2eaa9913-d349-4367-9e3d-610e7d36af8a"}],"id":"a262527d-dd84-4319-897b-84ff187c7bc2","description":"To authenticate each request, a client must send a JSON Web Token (JWT) in the authorization header of the HTTP request to the backend API. The server validates a JWT and caches it for sixty minutes (default). You can request a token by sending POST on /api/mdm/login endpoint with a username and password in BODY.
The /api/mdm/user endpoint returns a list of users with their attributes, groups, and devices. The list can be narrowed down by using the proper parameters.
List of available params:
\nfirstName
\nlastName
\nusername
\nphoneNumber
\nwithoutDevices
\nactivation
\nmodel[]
\nsystem[]
\ngroup[]
\ngroupless
\nvip
\nsuperAdmin
\nblockedUser
\naccount
\nIn this case, all parameters are optional.
\n","urlObject":{"protocol":"https","path":["api","mdm","user"],"host":["{{SERVER}}"],"query":[{"disabled":true,"description":{"content":"The optional string value with a user's first name.
The optional string value with a user's last name.
The optional string value with a user's email address.
The optional string value with a user's username.
The optional string value with a user's phone number.
The optional boolean value (true/false) determines whether the user has a device.
The optional int value determines whether device activation is:
0 (not set)1 (already set)2 (expired)The optional string value with a device model name. Multiple models can be provided as: ?model[]=SM-A536B&model[]=iPhone 12.
The optional string value with a device operating system version. Multiple versions can be provided as: ?system[]=Android 10&system[]=Android 11.
The optional int value with a user group id. Multiple group can be provided as: ?group[]=11&system[]=group 12.
The optional boolean value (true/false) determines whether the user does not belong to any group.
The optional boolean value (true/false) determines whether the user is marked as VIP.
The optional boolean value (true/false) determines whether the user has a super admin rights.
The optional boolean value (true/false) determines whether the user is currently blocked.
The optional string value determines whether the user was imported from Active Directory or created as a local user.
local (means created as a local user)ad (means imported from Active Directory)The optional int value indicates the number of records the API must fetch. The default value of the limit will be 50. A single API request can fetch a maximum of 250 resources.
The optional int value indicates from which point the records will be fetched. The default value of from parameter is 0.
This set of endpoints allows you to manage user accounts within the system. You can retrieve detailed information about existing users and add and remove labels. All requests must be authenticated using a valid JSON Web Token (JWT) in the authorization header. The system ensures that only authorized administrators can perform user-related actions. All operations respect control over user access and roles within the platform.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"04342cf2-decf-40a8-9914-f5c226639188","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"205d7c47-0b5a-4d6c-8357-69f871120358","type":"text/javascript","exec":[""]}}],"_postman_id":"8f912935-f428-465f-9937-f9fac8778b17"},{"name":"Activations","item":[{"name":"Generate Manual activation details without user","id":"33054523-fb04-4cde-8abd-5293b215bc6b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"activationTemplateId\": \"{{ACTIVATION_TEMPLATE_UUID}}\",\n \"sendEmail\": false,\n \"count\": 1\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/activation","description":"This POST request allows you to generate activation details for a device without a user. Through this endpoint, you can get details on how to enroll a single device.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":true,"source":{"_postman_id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","name":"PROGET API","type":"collection"}},"urlObject":{"protocol":"https","path":["api","mdm","activation"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[{"id":"33fa4ed9-ac18-4f13-86d0-037ee6c64289","name":"201 Created - Manual activation details without user","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"activationTemplateId\": \"{{ACTIVATION_TEMPLATE_UUID}}\",\n \"sendEmail\": false,\n \"count\": 1\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/activation"},"status":"Created","code":201,"_postman_previewlanguage":null,"header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 10 Apr 2026 19:45:32 GMT"},{"key":"server-version","value":"20260302"},{"key":"Permissions-Policy","value":"interest-cohort=()"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"activation\": {\n \"id\": 1108,\n \"uuid\": \"1649580f-e845-4484-833d-772510ae1e9f\",\n \"pin\": \"1291\",\n \"createdAt\": \"2023-01-01 23:59:59\",\n \"expirationDate\": \"2023-01-02 23:59:59\",\n \"type\": \"android_for_work_device_owner\",\n \"email\": null,\n \"active\": true,\n \"identifier\": \"0DE91E9D\",\n \"templateConfiguration\": {\n \"allowMultipleActivations\": false,\n \"expirationDays\": 1,\n \"maxAttempts\": 3,\n \"passwordLength\": 4,\n \"identifierLength\": 8,\n \"emailData\": {\n \"deliveryMode\": \"ask\",\n \"subject\": \"Activation subject details here...\",\n \"message\": \"Activation message details here...\"\n },\n \"leaveSystemApplications\": false,\n \"wifiData\": null,\n \"addAndroidEnterpriseAccount\": true\n },\n \"eula\": {\n \"id\": \"ae09a1d8-85be-4222-93d4-a57f47180797\",\n \"name\": \"Custom Eula - Android Enterprise Device Owner\"\n }\n },\n \"serverHostname\": \"example.domain.com\",\n \"userDisplayName\": null,\n \"qrcode\": \"data:image/svg+xml;base64,base64QRcodeencodedvalue\"\n}"},{"id":"8f250d5e-9084-44cd-af8d-143eab419184","name":"400 Bad Request - Activation template not found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"activationTemplateId\": \"009b4f75-e5da-4b75-a454-20b007931532\",\n \"sendEmail\": false,\n \"count\": 1\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/activation"},"status":"Bad Request","code":400,"_postman_previewlanguage":null,"header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 10 Apr 2026 19:59:24 GMT"},{"key":"server-version","value":"20260302"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Validation Failed\",\n \"errors\": {\n \"children\": {\n \"sendEmail\": [],\n \"user\": [],\n \"count\": [],\n \"activationTemplateId\": {\n \"errors\": [\n \"Activation template not found\"\n ]\n }\n },\n \"_extraFields\": []\n }\n}"}],"_postman_id":"33054523-fb04-4cde-8abd-5293b215bc6b"},{"name":"Generate Manual activation details with user","id":"21f07e11-340f-4f1c-aa4e-ed8c6a462b17","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"activationTemplateId\": \"{{ACTIVATION_TEMPLATE_UUID}}\",\n \"sendEmail\": false,\n \"user\": \"{{USER_UUID}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/activation","description":"This POST request allows you to generate activation details for a device with a user. Through this endpoint, you can get details on how to enroll a single device associated with a user.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":true,"source":{"_postman_id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","name":"PROGET API","type":"collection"}},"urlObject":{"protocol":"https","path":["api","mdm","activation"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[{"id":"f5249a30-9321-4e55-8cbe-e082c45a8c4c","name":"201 Created - Manual activation details with user","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"activationTemplateId\": \"{{ACTIVATION_TEMPLATE_UUID}}\",\n \"sendEmail\": false,\n \"user\": \"{{USER_UUID}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/activation"},"status":"Created","code":201,"_postman_previewlanguage":null,"header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 10 Apr 2026 19:46:27 GMT"},{"key":"server-version","value":"20260302"},{"key":"Permissions-Policy","value":"interest-cohort=()"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"activation\": {\n \"id\": 1108,\n \"uuid\": \"1649580f-e845-4484-833d-772510ae1e9f\",\n \"pin\": \"1291\",\n \"createdAt\": \"2023-01-01 23:59:59\",\n \"expirationDate\": \"2023-01-02 23:59:59\",\n \"type\": \"android_for_work_device_owner\",\n \"email\": \"john.doe@example.com\",\n \"active\": true,\n \"identifier\": \"DDDD4C70\",\n \"templateConfiguration\": {\n \"allowMultipleActivations\": false,\n \"expirationDays\": 1,\n \"maxAttempts\": 3,\n \"passwordLength\": 4,\n \"identifierLength\": 8,\n \"emailData\": {\n \"deliveryMode\": \"ask\",\n \"subject\": \"Activation subject details here...\",\n \"message\": \"Activation message details here...\"\n },\n \"leaveSystemApplications\": false,\n \"wifiData\": null,\n \"addAndroidEnterpriseAccount\": true\n },\n \"eula\": {\n \"id\": \"ae09a1d8-85be-4222-93d4-a57f47180797\",\n \"name\": \"Custom Eula - Android Enterprise Device Owner\"\n }\n },\n \"serverHostname\": \"example.domain.com\",\n \"userDisplayName\": \"John Doe\",\n \"qrcode\": \"data:image/svg+xml;base64,base64QRcodeencodedvalue\"\n}"},{"id":"7d7cb3d9-0f7f-4162-a13a-0e28d3608e32","name":"400 Bad Request - Activation template not found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"activationTemplateId\": \"009b4f75-e5da-4b75-a454-20b007931532\",\n \"sendEmail\": false,\n \"user\": \"{{USER_UUID}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/activation"},"status":"Bad Request","code":400,"_postman_previewlanguage":null,"header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 10 Apr 2026 19:58:26 GMT"},{"key":"server-version","value":"20260302"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Validation Failed\",\n \"errors\": {\n \"children\": {\n \"sendEmail\": [],\n \"user\": [],\n \"count\": [],\n \"activationTemplateId\": {\n \"errors\": [\n \"Activation template not found\"\n ]\n }\n },\n \"_extraFields\": []\n }\n}"},{"id":"3710d5b9-ba6c-4564-9891-423e90d08a79","name":"404 Not Found - User not found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"activationTemplateId\": \"{{ACTIVATION_TEMPLATE_UUID}}\",\n \"sendEmail\": false,\n \"user\": \"009b4f75-e5da-4b75-a454-20b007931533\"\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/activation"},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 10 Apr 2026 19:58:51 GMT"},{"key":"server-version","value":"20260302"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404\n}"}],"_postman_id":"21f07e11-340f-4f1c-aa4e-ed8c6a462b17"},{"name":"Get the list of Activation templates","id":"3f88b79e-40df-4deb-859d-effd6bb030b1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://{{SERVER}}/api/mdm/activation-template","description":"The /api/mdm/activation-template endpoint returns a list of activation templates. The list can be narrowed down by using the proper parameters.
name
\nactivationTypes[]
\neulaId[]
\nIn this case, all parameters are optional.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":true,"source":{"_postman_id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","name":"PROGET API","type":"collection"}},"urlObject":{"protocol":"https","path":["api","mdm","activation-template"],"host":["{{SERVER}}"],"query":[{"disabled":true,"description":{"content":"The optional string value with a template's name.
The optional string value with the EULA's uuid.
The optional string value determines what activation template is searched.
android_for_work_device_ownerandroid_for_work_work_profileandroid_mdmios_mdmmacos_mdmwindows_mdmThe optional int value indicates the number of records the API must fetch. The default value of the limit will be 50. A single API request can fetch a maximum of 250 resources.
The optional int value indicates from which point the records will be fetched. The default value of from parameter is 0.
The /api/mdm/activation-template/{{ACTIVATION_TEMPLATE_UUID}} endpoint returns details of a specific activation template. Activation template details could be retrieved by providing an activation template's UUID.
This POST request allows you to add an automatic enrollment record by the device IMEI number.
\n","urlObject":{"protocol":"https","path":["api","mdm","auto-enroll"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[{"id":"d248bdea-08cb-407a-afef-ad45d115e704","name":"201 Created - Automatic registration transaction id","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"imei\",\n \"integration\": \"proget\",\n \"autoEnrollments\": [\n {\n \"id\": \"{{DEVICE_IMEI}}\",\n \"activationTemplateId\": \"{{ACTIVATION_TEMPLATE_UUID}}\",\n \"policy\": null,\n \"alias\": \"\",\n \"actionOnActivate\": \"noAction\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/auto-enroll"},"status":"Created","code":201,"_postman_previewlanguage":null,"header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 10 Apr 2026 19:47:36 GMT"},{"key":"server-version","value":"20260302"},{"key":"Permissions-Policy","value":"interest-cohort=()"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"transactionId\": \"de92ef49-fc4d-4de5-95d8-1d3e0dfc9dca\"\n}"},{"id":"32537729-c526-4c35-a4d8-1bd336bd312a","name":"400 Bad Request","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"imei\",\n \"integration\": \"proget\",\n \"autoEnrollments\": [\n {\n \"id\": \"{{DEVICE_IMEI}}\",\n \"activationTemplateId\": \"fdgfdg\",\n \"policy\": null,\n \"alias\": \"\",\n \"actionOnActivate\": \"noAction\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/auto-enroll"},"status":"Bad Request","code":400,"_postman_previewlanguage":null,"header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 10 Apr 2026 19:55:22 GMT"},{"key":"server-version","value":"20260302"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":"{}"}],"_postman_id":"d72966c8-074a-4a90-aea5-0e1e4606e297"},{"name":"Add Automatic registration with KME by IMEI","event":[{"listen":"test","script":{"id":"fd4045b2-d22b-4df3-91f8-dddb925d600e","exec":["pm.test(\"Status code is 201\", function () {"," pm.response.to.have.status(201);","});","","if(pm.response.code === 201){"," pm.test(\"Proget transaction created\", function () {"," pm.expect(pm.response.json().transactionId).to.exist;"," pm.environment.set(\"PROGET_TRANSACTIONID\", pm.response.json().transactionId);"," });","}"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"8bf95542-b569-40d2-95e8-efc52ce72bb6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"imei\",\n \"integration\": \"kme\",\n \"autoEnrollments\": [\n {\n \"id\": \"{{DEVICE_IMEI}}\",\n \"activationTemplateId\": \"{{ACTIVATION_TEMPLATE_UUID}}\",\n \"policy\": null,\n \"alias\": \"\",\n \"actionOnActivate\": \"noAction\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/auto-enroll","description":"This POST request allows you to add an automatic enrollment record by the device IMEI number.
\n","urlObject":{"protocol":"https","path":["api","mdm","auto-enroll"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[{"id":"549b73f8-b6bd-425b-898d-7fb37cfae020","name":"201 Created - Automatic registration transaction id","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"imei\",\n \"integration\": \"kme\",\n \"autoEnrollments\": [\n {\n \"id\": \"{{DEVICE_IMEI}}\",\n \"activationTemplateId\": \"{{ACTIVATION_TEMPLATE_UUID}}\",\n \"policy\": null,\n \"alias\": \"\",\n \"actionOnActivate\": \"noAction\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/auto-enroll"},"status":"Created","code":201,"_postman_previewlanguage":null,"header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 29 May 2026 21:26:43 GMT"},{"key":"server-version","value":"20260401"},{"key":"Permissions-Policy","value":"interest-cohort=()"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"transactionId\": \"c9f319b8-c228-4dbf-aab6-2c4587b3a91b\"\n}"},{"id":"7aae4b82-2732-4e9b-81c2-bc6fdc55e35e","name":"400 Bad Request","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"imei\",\n \"integration\": \"kme\",\n \"autoEnrollments\": [\n {\n \"id\": \"{{DEVICE_IMEI}}\",\n \"activationTemplateId\": \"{{ACTIVATION_TEMPLATE_UUID}}\",\n \"policy\": null,\n \"alias\": \"\",\n \"actionOnActivate\": \"noAction\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/auto-enroll"},"status":"Bad Request","code":400,"_postman_previewlanguage":null,"header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 29 May 2026 21:27:15 GMT"},{"key":"server-version","value":"20260401"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Validation Failed\",\n \"errors\": {\n \"children\": {\n \"integration\": [],\n \"type\": [],\n \"autoEnrollments\": {\n \"children\": [\n {\n \"children\": {\n \"user\": [],\n \"activationTemplateId\": [],\n \"alias\": [],\n \"policy\": [],\n \"actionOnActivate\": [],\n \"id\": {\n \"errors\": [\n \"Ta wartość jest nieprawidłowa.\"\n ]\n }\n }\n }\n ]\n }\n },\n \"_extraFields\": []\n }\n}"}],"_postman_id":"8bf95542-b569-40d2-95e8-efc52ce72bb6"},{"name":"Add Automatic registration with Proget by SN","event":[{"listen":"test","script":{"id":"fd4045b2-d22b-4df3-91f8-dddb925d600e","exec":["pm.test(\"Status code is 201\", function () {"," pm.response.to.have.status(201);","});","","if(pm.response.code === 201){"," pm.test(\"Proget transaction created\", function () {"," pm.expect(pm.response.json().transactionId).to.exist;"," pm.environment.set(\"PROGET_TRANSACTIONID\", pm.response.json().transactionId);"," });","}"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"c6fd629a-cf4d-440a-9a2e-9e0defefbe4b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"serial-number\",\n \"integration\": \"proget\",\n \"autoEnrollments\": [\n {\n \"id\": \"{{DEVICE_SN}}\",\n \"activationTemplateId\": \"{{ACTIVATION_TEMPLATE_UUID}}\",\n \"policy\": null,\n \"alias\": \"\",\n \"actionOnActivate\": \"noAction\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/auto-enroll","description":"This POST request allows you to add an automatic enrollment record by the device serial number.
\n","urlObject":{"protocol":"https","path":["api","mdm","auto-enroll"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[{"id":"c13d38ea-adea-4e8d-b4e2-e3581b55ff47","name":"201 Created - Automatic registration transaction id","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"serial-number\",\n \"integration\": \"proget\",\n \"autoEnrollments\": [\n {\n \"id\": \"{{DEVICE_SN}}\",\n \"activationTemplateId\": \"{{ACTIVATION_TEMPLATE_UUID}}\",\n \"policy\": null,\n \"alias\": \"\",\n \"actionOnActivate\": \"noAction\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/auto-enroll"},"status":"Created","code":201,"_postman_previewlanguage":null,"header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 10 Apr 2026 19:48:49 GMT"},{"key":"server-version","value":"20260302"},{"key":"Permissions-Policy","value":"interest-cohort=()"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"transactionId\": \"c9303c91-18d3-466f-8eb0-81e78aec3fad\"\n}"},{"id":"a7a24d29-7d26-4b39-930c-42a650a0c4be","name":"400 Bad Request","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"type\": \"serial-number\",\n \"integration\": \"proget\",\n \"autoEnrollments\": [\n {\n \"id\": \"{{DEVICE_SN}}\",\n \"activationTemplateId\": \"23456\",\n \"policy\": null,\n \"alias\": \"\",\n \"actionOnActivate\": \"noAction\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/auto-enroll"},"status":"Bad Request","code":400,"_postman_previewlanguage":null,"header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 10 Apr 2026 19:54:33 GMT"},{"key":"server-version","value":"20260302"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":"{}"}],"_postman_id":"c6fd629a-cf4d-440a-9a2e-9e0defefbe4b"},{"name":"Delete Automatic registration with Proget by device ID(s)","id":"3f1ef37a-32d1-4d53-a1e1-05829cb347fb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n \"ids\": [\n \"{{DEVICE_ID}}\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/auto-enroll/proget","description":"This DELETE request allows you to remove an automatic device enrollment record by device ID(s), such as the device's IMEI or serial number.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":true,"source":{"_postman_id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","name":"PROGET API","type":"collection"}},"urlObject":{"protocol":"https","path":["api","mdm","auto-enroll","proget"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[{"id":"fb8cad01-d5be-4287-be4f-348c04b0cf31","name":"204 No Content - Deleted","originalRequest":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n \"ids\": [\n \"{{DEVICE_SN}}\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/auto-enroll/proget"},"status":"No Content","code":204,"_postman_previewlanguage":null,"header":[{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 10 Apr 2026 19:49:28 GMT"},{"key":"server-version","value":"20260302"},{"key":"Permissions-Policy","value":"interest-cohort=()"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":null},{"id":"2376d504-65d8-48a2-a564-aed634f57995","name":"400 Bad Request - The object with id '%id%' does not exist","originalRequest":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n \"ids\": [\n \"{{DEVICE_SN}}\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/auto-enroll/proget"},"status":"Bad Request","code":400,"_postman_previewlanguage":null,"header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 10 Apr 2026 19:54:02 GMT"},{"key":"server-version","value":"20260302"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Validation Failed\",\n \"errors\": {\n \"children\": {\n \"ids\": {\n \"children\": [\n {\n \"errors\": [\n \"The object with id '%id%' does not exist.\"\n ]\n }\n ]\n }\n },\n \"_extraFields\": []\n }\n}"}],"_postman_id":"3f1ef37a-32d1-4d53-a1e1-05829cb347fb"},{"name":"Get list of Activations","id":"92c28ca8-0c1f-40bb-81af-e6dbb4ce2625","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://{{SERVER}}/api/mdm/activation","description":"The /api/mdm/activation endpoint returns a list of activation records in the system. The list can be narrowed down by using the proper parameters.
identifier
\nactivationType[]
\neulaId[]
\ncreatedFor
\nIn this case, all parameters are optional.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":true,"source":{"_postman_id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","name":"PROGET API","type":"collection"}},"urlObject":{"protocol":"https","path":["api","mdm","activation"],"host":["{{SERVER}}"],"query":[{"disabled":true,"description":{"content":"The optional string value with an identifier number.
The optional string value determines what activation template is searched.
android_for_work_device_ownerandroid_for_work_work_profileandroid_mdmios_mdmmacos_mdmwindows_mdmThe optional string value with the EULA's uuid.
The optional string value with the admin user's uuid.
The optional int value indicates the number of records the API must fetch. The default value of the limit will be 50. A single API request can fetch a maximum of 250 resources.
The optional int value indicates from which point the records will be fetched. The default value of from parameter is 0.
The /api/mdm/activation/{{ACTIVATION_UUID}} endpoint returns details of a specific activation. Activation details could be retrieved by providing an activation record's UUID.
This set of endpoints allows you to manage activation within the system. You can generate detailed device enrollment information, with or without a user. You can also retrieve detailed information about existing activations. All requests must be authenticated using a valid JSON Web Token (JWT) in the authorization header. The system ensures that only authorized administrators can perform user-related actions. All operations respect control over user access and roles within the platform.
\n","_postman_id":"6d8ed3a1-b6ed-4b31-90c5-ec7f751ee1dc","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":true,"source":{"_postman_id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","name":"PROGET API","type":"collection"}}},{"name":"Devices management","item":[{"name":"Device Owner","item":[{"name":"Wipe company data (deactivate Device)","event":[{"listen":"test","script":{"id":"260fa2e3-6a6c-490a-86d1-2e48d64c82c8","exec":["pm.response.to.have.status(204);"],"type":"text/javascript"}}],"id":"091bfe9a-2e2d-495b-a4bc-e34de06ecad8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"javascript"}}},"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_UUID}}/deactivate","description":"This POST request allows you to send a Wipe company data (deactivate device) command to a particular device.
This POST request allows you to send a text message to a particular device with the required device id and message. Below you can find the possible keys and values of a request body.
application/json
This POST request lets you send a restart command to a particular device. The endpoint URI must point to the device's UUID.
\napplication/json
This POST request disables kiosk mode on a specific device.
\nThe endpoint targets the device identified by {{DEVICE_UUID}} and removes or deactivates the kiosk mode currently applied to that device in Proget MDM.
/api/mdm/device/{{DEVICE_UUID}}/profile/kiosk/disable
Disables kiosk mode for the selected device
\nUses the device UUID in the request path
\nReturns 204 No Content when the operation succeeds
{{SERVER}} — Proget API server base URL
{{DEVICE_UUID}} — unique identifier of the target device
application/json
This request does not require a request body
\nEnsure the target device exists and is currently configured for kiosk mode before calling this endpoint
\nThis POST request enables kiosk mode on a specific device.
\nThe endpoint targets the device identified by {{DEVICE_UUID}} and applies the kiosk profile configuration associated with that device in Proget MDM.
/api/mdm/device/{{DEVICE_UUID}}/profile/kiosk/enable
Enables kiosk mode for the selected device
\nUses the device UUID in the request path
\nReturns 204 No Content when the operation succeeds
{{SERVER}} — Proget API server base URL
{{DEVICE_UUID}} — unique identifier of the target device
application/json
This request does not require a request body
\nEnsure the target device exists and has a kiosk-capable profile assigned before calling this endpoint
\nThis POST request allows you to send an alert message to a particular device with the required device id and message. The alarm message generates a sound by default, regardless of the device's volume profile. Below you can find the possible keys and values of a request body.
application/json
This POST request allows you to send a Wipe device command to a particular device.
This POST request allows you to send a Block device command to a particular device.
application/json
This POST request allows you to send a Unlock device command to a particular device.
application/json
none
This POST request allows you to send a Unblock device command to a particular device.
application/json
none
This endpoint group delivers functionality for managing devices registering as Android Enterprise in Device Owner mode.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"71d5a051-6b94-42ec-82c0-4b96f0103a05","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"c09052b1-209a-4b13-b8f5-a4ac6cfa1e15","type":"text/javascript","exec":[""]}}],"_postman_id":"c877c773-438e-473f-b98a-7d7168e6309c"},{"name":"iOS","item":[{"name":"Device lock","event":[{"listen":"test","script":{"id":"10f7e295-cdaa-4d68-a3fc-f4d6ba82cf4f","exec":["pm.test(\"Status code is 204 - lost mode command sent\", function () {"," pm.response.to.have.status(204);","});"],"type":"text/javascript","packages":{}}}],"id":"c0943b92-0e3a-433f-bf41-59884eb9a3d9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"message\": \"12345\",\n\t\"phoneNumber\": \"12345\"\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_ID}}/lostmode","description":"This POST request allows you to send a Block device command to a particular device.
application/json
This POST request allows you to refresh the device data.
\napplication/json
none
This POST request allows you to clear device passcode.
\napplication/json
none
This DELETE request allows you to send a Unlock device command to a particular device.
application/json
Assigns an Apple Business profile to one or more managed devices.
\nThis endpoint sends a request to associate the Apple Business profile identified by {{AB_PROFILE_ID}} with the specified device IDs. The request body accepts an ids array containing the target device identifiers, allowing profile assignment to selected devices in a single call.
Request details:
\nMethod: POST
URL: https://{{SERVER}}/api/mdm/device/profile/dep/{{AB_PROFILE_ID}}
Request body:
\n{\n \"ids\": [\n {{DEVICE_ID}}\n ]\n}\n\nExpected response:
\n204 No Content when the profile has been successfully assigned and no response body is returned.Unassigns an Apple Business profile from one or more managed devices.
\nThis endpoint sends a request to remove the association between Apple Business profiles and the specified device IDs. The request body accepts an ids array containing the target device identifiers, allowing profile unassignment from selected devices in a single call.
Request details:
\nMethod: DELETE
URL: https://{{SERVER}}/api/mdm/device/profile/dep
Request body:
\n{\n \"ids\": [\n {{DEVICE_ID}}\n ]\n}\n\nExpected response:
\n204 No Content when the profile has been successfully unassigned and no response body is returned.This endpoint group delivers functionality for managing devices registering as iOS.
\n","_postman_id":"6e0e0fbe-66d4-45cf-b756-72916db35e4d","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":true,"source":{"_postman_id":"25a4124f-8ca0-4737-ac13-4f588a5f26bb","id":"25a4124f-8ca0-4737-ac13-4f588a5f26bb","name":"Devices management","type":"folder"}}},{"name":"Get Devices list with details","event":[{"listen":"test","script":{"id":"5e6018ac-e76b-48c2-be0b-2076a335abe3","exec":["pm.response.to.have.status(200);","pm.expect(pm.response.json().items[0].uuid).not.equal(null);","pm.expect(pm.response.json().items[0].id).not.equal(null);","pm.environment.set(\"DEVICE_UUID\", pm.response.json().items[0].uuid);","pm.environment.set(\"DEVICE_ID\", pm.response.json().items[0].id);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"bda89211-dfd2-42cb-b6c7-adfff955fca9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"https://{{SERVER}}/api/mdm/device","description":"The /api/mdm/device endpoint returns a list of devices with their attributes The list can be narrowed down by using the proper parameters.
List of available params:
\nimei
\nserialNumberalias
\niccId
\ninactiveFrom
\ninactiveTo
\nactive
\nsecurityStatus
\nandroidEnterpriseStatus[]
\nownership
\nprogetId
\nactivatedAtFrom
\nactivatedAtUntil
\nactivation[]
\nlocked
\nvendor[]
\nmodel[]
\nsystem[]
\ngroup[]
\ndepStatus
\ngroupless
\nlimit
\noffset
\nIn this case, all parameters are optional.
\n","urlObject":{"protocol":"https","path":["api","mdm","device"],"host":["{{SERVER}}"],"query":[{"disabled":true,"description":{"content":"The optional string value with a device's IMEI number.
The optional string value with a device's serial number.
The optional string value with a device's alias.
The optional string value with a SIM card ICCID.
The optional int value determines the beginning of the range of days for the device's last contact. Values in the range of 0-90 are accepted.
The optional int value determines the end of the range of days for the device's last contact. Values in the range of 0-90 are accepted.
The optional boolean value (true/false) determines whether the device is active.
The optional string value determines the level of device security. Available values:
safeunsafecriticalThe optional string value determines the state of Android Enterprise activation. Available values:
activatedduringActivationnotActivated\nMultiple state can be provided as: ?androidEnterpriseStatus[]=duringActivation&androidEnterpriseStatus[]=notActivated.The optional string value determines the ownership of a device. Available values:
privateworkwork-profile (WPC)The optional string value with a unique device identifier.
The optional date value determines the date of device activation. The parameter defines the beginning of the period. Date format: YYYY-MM-DD.
The optional date value determines the date of device activation. The parameter defines the end of the period. Date format: YYYY-MM-DD.
The optional string value determines the device activation type(s). Available values:
android_for_work_device_owner (Android Enterprise Device Owner)android_for_work_work_profile (Android Enterprise Profile Owner / COPE)android_mdm (Android)ios_mdm (iOS)macos_mdm (macOS)knox_mdm (Samsung Knox) - depreciated\nMultiple activation types can be provided as: ?activation[]=android_for_work_device_owner&activation[]=ios_mdm.The optional boolean value (true/false) determines whether the device is blocked.
The optional string value determines the device's manufacturers. For example:
APPLESAMSUNGMOTOROLAHMD GLOBAL\nMultiple manufacturers can be provided as: ?vendor[]=APPLE&vendor[]=SAMSUNG.The optional string value determines the device's models. For example:
iPhone 12SM-A536Bmoto g(100)\nMultiple models can be provided as: ?model[]=iPhone 12&model[]=SM-A536B.The optional string value determines the device's operating system. For example:
Android 13iOS 16.4.1\nMultiple operating systems can be provided as: ?system[]=Android 13&system[]=iOS 16.4.1.The optional string value specifies the group id(s) in which the user of a given device is located. For example:
1112\nMultiple group ids can be provided as: ?group[]=11&group[]=12.The optional string value determines the Apple device has an Apple Business Manager profile assigned. Available values:
assignedunassignedThe optional boolean value (true/false) specifies whether a given device's user does not belong to any group.
The optional int value indicates the number of records the API must fetch. The default value of the limit will be 50. A single API request can fetch a maximum of 250 resources.
The optional int value indicates from which point the records will be fetched. The default value of from parameter is 0.
This GET request allows you to display the device's security information.
\n","urlObject":{"protocol":"https","path":["api","mdm","device","{{DEVICE_ID}}","warning"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[{"id":"c0f5d0c7-ff36-40b1-9729-e2fa6776f8bf","name":"200 OK - Device's security information","originalRequest":{"method":"GET","header":[],"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_ID}}/warning"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Wed, 19 Apr 2023 10:32:56 GMT"},{"key":"Permissions-Policy","value":"interest-cohort=()"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": 40,\n \"deviceId\": 3310,\n \"severity\": \"safe\",\n \"name\": \"warning.accessibility.status.enabled\",\n \"createdAt\": \"2023-01-01 12:00:00\",\n \"descriptions\": []\n },\n {\n \"id\": 42,\n \"deviceId\": 3310,\n \"severity\": \"safe\",\n \"name\": \"warning.android_enterprise.status.safe\",\n \"createdAt\": \"2023-01-01 12:00:00\",\n \"descriptions\": []\n },\n {\n \"id\": 41,\n \"deviceId\": 3310,\n \"severity\": \"safe\",\n \"name\": \"warning.android.root.status\",\n \"createdAt\": \"2023-01-01 12:00:00\",\n \"descriptions\": []\n },\n {\n \"id\": 38,\n \"deviceId\": 3310,\n \"severity\": \"safe\",\n \"name\": \"warning.android.safetynet.attestation.status\",\n \"createdAt\": \"2023-01-01 12:00:00\",\n \"descriptions\": {\n \"items\": [\n \"Certified, genuine device that passes CTS\"\n ]\n }\n },\n {\n \"id\": 37,\n \"deviceId\": 3310,\n \"severity\": \"safe\",\n \"name\": \"warning.android.safetynet.verify_apps.status\",\n \"createdAt\": \"2023-01-01 12:00:00\",\n \"descriptions\": []\n },\n {\n \"id\": 35,\n \"deviceId\": 3310,\n \"severity\": \"info\",\n \"name\": \"warning.applications.installed.proget_remote.info\",\n \"createdAt\": \"2023-01-01 12:00:00\",\n \"descriptions\": []\n },\n {\n \"id\": 39,\n \"deviceId\": 3310,\n \"severity\": \"safe\",\n \"name\": \"warning.wifi.control.status.enabled\",\n \"createdAt\": \"2023-01-01 12:00:00\",\n \"descriptions\": []\n }\n]"},{"id":"ad7f3fd1-255d-4024-bf71-89124dfcc0d3","name":"404 Not Found - Wrong device uuid or device does not exist","originalRequest":{"method":"GET","header":[],"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_ID}}/warning"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Wed, 19 Apr 2023 10:34:15 GMT"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404\n}"}],"_postman_id":"2ee2d16c-2bd8-481f-ba20-3d9dc0d7ee3a"},{"name":"Assing User to Device","event":[{"listen":"test","script":{"id":"64c694ea-44de-4b81-a742-298a525db395","exec":["pm.response.to.have.status(204);"],"type":"text/javascript"}}],"id":"23ff0669-286e-4487-89bc-1e0fa669e408","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_UUID}}/user/{{USER_ID}}","description":"This POST request allows you to assign a user to a specified device.
\n","urlObject":{"protocol":"https","path":["api","mdm","device","{{DEVICE_UUID}}","user","{{USER_ID}}"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[{"id":"36a0aa48-86cb-453b-bb4c-61b8c5606cfd","name":"204 No Content - Success","originalRequest":{"method":"POST","header":[],"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_UUID}}/user/{{USER_ID}}"},"status":"No Content","code":204,"_postman_previewlanguage":"plain","header":[{"key":"Server","value":"nginx"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Tue, 18 Apr 2023 12:35:11 GMT"},{"key":"Permissions-Policy","value":"interest-cohort=()"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"}],"cookie":[],"responseTime":null,"body":null},{"id":"815f14bb-8258-4930-942b-0c726403a430","name":"404 Not Found - Wrong device uuid / user id or device / user does not exist","originalRequest":{"method":"POST","header":[],"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_UUID}}/user/{{USER_ID}}"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Wed, 19 Apr 2023 10:58:51 GMT"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404\n}"}],"_postman_id":"23ff0669-286e-4487-89bc-1e0fa669e408"},{"name":"Unassign User","event":[{"listen":"test","script":{"id":"330eba63-c4d7-4b74-b7e0-f3c24f9e83d4","exec":["pm.response.to.have.status(204);"],"type":"text/javascript"}}],"id":"af4887ee-bf5c-4c49-a120-7305167920ba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"DELETE","header":[],"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_UUID}}/user","description":"This DELETE request allows you to unassign a user from a specified device.
\n","urlObject":{"protocol":"https","path":["api","mdm","device","{{DEVICE_UUID}}","user"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[{"id":"3b72889d-3c53-4a17-803c-b99289aab65e","name":"204 No Content - Success","originalRequest":{"method":"DELETE","header":[],"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_UUID}}/user"},"status":"No Content","code":204,"_postman_previewlanguage":"plain","header":[{"key":"Server","value":"nginx"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Tue, 18 Apr 2023 12:34:52 GMT"},{"key":"Permissions-Policy","value":"interest-cohort=()"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"}],"cookie":[],"responseTime":null,"body":null},{"id":"470736e8-157b-4cdb-80cf-bbeec0af434d","name":"404 Not Found - Wrong device uuid or device does not exist","originalRequest":{"method":"DELETE","header":[],"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_UUID}}/user"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Wed, 19 Apr 2023 10:53:47 GMT"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404\n}"}],"_postman_id":"af4887ee-bf5c-4c49-a120-7305167920ba"},{"name":"Locate Device","event":[{"listen":"test","script":{"id":"59c3c53a-f27d-49dd-bff3-5ace04c97535","exec":["pm.response.to.have.status(204);"],"type":"text/javascript"}}],"id":"b6391b5c-4cd2-4d24-876f-20af872a508d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_ID}}/locate","description":"This POST request allows you to ask a device to deliver its current location. The request won't return the location in response, but it will only create a task to send its existing location on demand.
\n","urlObject":{"protocol":"https","path":["api","mdm","device","{{DEVICE_ID}}","locate"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[{"id":"6987c047-f697-41b1-9161-d73da8190e7a","name":"204 No Content - Success","originalRequest":{"method":"POST","header":[],"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_ID}}/locate"},"status":"No Content","code":204,"_postman_previewlanguage":"plain","header":[{"key":"server","value":"nginx"},{"key":"cache-control","value":"no-cache, private"},{"key":"date","value":"Wed, 24 Jan 2024 22:40:35 GMT"},{"key":"server-version","value":"20231000"},{"key":"permissions-policy","value":"interest-cohort=()"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"}],"cookie":[],"responseTime":null,"body":null},{"id":"baab1598-77a6-4ea8-8ba6-efd05c22c4d6","name":"404 Not Found - Wrong device id or device does not exist","originalRequest":{"method":"POST","header":[],"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_ID}}/locate"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"server","value":"nginx"},{"key":"content-type","value":"application/json"},{"key":"transfer-encoding","value":"chunked"},{"key":"cache-control","value":"no-cache, private"},{"key":"date","value":"Wed, 24 Jan 2024 22:41:19 GMT"},{"key":"server-version","value":"20231000"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404\n}"}],"_postman_id":"b6391b5c-4cd2-4d24-876f-20af872a508d"},{"name":"Get Device locations","event":[{"listen":"test","script":{"id":"4e4c7843-2c87-4e8b-b9ca-591dcf366d5e","exec":["pm.response.to.have.status(200);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"57e1a36c-61e3-4b8f-b071-7d1c4c1f0579","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_ID}}/location","description":"This GET request allows you to get the list of a device's latest locations stored on the server.
\n","urlObject":{"protocol":"https","path":["api","mdm","device","{{DEVICE_ID}}","location"],"host":["{{SERVER}}"],"query":[{"disabled":true,"description":{"content":"The optional int value indicates the number of records the API must fetch. The default value of the limit will be 20. A single API request can fetch a maximum of 250 resources.
The optional int value indicates from which point the records will be fetched. The default value of from parameter is 0.
This GET request allows you to get the device details. The value you are searching by is the Serial Number.
\n","urlObject":{"protocol":"https","path":["api","mdm","device",""],"host":["{{SERVER}}"],"query":[{"description":{"content":"The optional string value with a device's serial number.
This GET request allows you to get the device details. The value you are searching by is the IMEI.
\n","urlObject":{"protocol":"https","path":["api","mdm","device",""],"host":["{{SERVER}}"],"query":[{"description":{"content":"The optional string value with a device's IMEI number.
This POST request allows you to force the device to contact the server.
\n","urlObject":{"protocol":"https","path":["api","mdm","device","{{DEVICE_UUID}}","status"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[{"id":"eb615059-f9d7-44b9-a111-186c1c1504df","name":"204 No Content - The command has been sent","originalRequest":{"method":"POST","header":[],"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_UUID}}/status"},"status":"No Content","code":204,"_postman_previewlanguage":"plain","header":[{"key":"server","value":"nginx"},{"key":"cache-control","value":"no-cache, private"},{"key":"date","value":"Wed, 16 Oct 2024 20:28:15 GMT"},{"key":"server-version","value":"20241000"},{"key":"permissions-policy","value":"interest-cohort=()"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-xss-protection","value":"1; mode=block"}],"cookie":[],"responseTime":null,"body":null},{"id":"9d7db7de-43e8-40ad-9547-894d21d7e6e0","name":"404 Not Found - Wrong device uuid or device does not exist","originalRequest":{"method":"POST","header":[],"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_UUID}}/status"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"server","value":"nginx"},{"key":"content-type","value":"application/json"},{"key":"transfer-encoding","value":"chunked"},{"key":"cache-control","value":"no-cache, private"},{"key":"date","value":"Wed, 16 Oct 2024 20:29:48 GMT"},{"key":"server-version","value":"20241000"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 404\n}"}],"_postman_id":"034a3bb4-1cf8-4f14-88f5-84a80d5f0efa"},{"name":"Get Android Device tasks","event":[{"listen":"test","script":{"id":"b42d97d6-6c58-4b2b-bb54-80762b061ecd","exec":["pm.test(\"Status code is 200\", function () {"," pm.response.to.have.status(200);","});"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"77e87c6f-268e-4741-a4b0-a5656f0135c7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/device/{{DEVICE_ID}}/task/application","description":"This GET request allows you to get the Android device's tasks.
\n","urlObject":{"protocol":"https","path":["api","mdm","device","{{DEVICE_ID}}","task","application"],"host":["{{SERVER}}"],"query":[{"disabled":true,"description":{"content":"The optional int value indicates the number of records the API must fetch. The default value of the limit will be 50. A single API request can fetch a maximum of 250 resources.
The optional int value indicates from which point the records will be fetched. The default value of from parameter is 0.
The optional string value determines the tasks's status. For example:
createdreceivedsuccessfailedcancelednotNowThis GET request allows you to get the iOS device's tasks.
\n","urlObject":{"protocol":"https","path":["api","mdm","device","{{DEVICE_ID}}","task","device"],"host":["{{SERVER}}"],"query":[{"disabled":true,"description":{"content":"The optional int value indicates the number of records the API must fetch. The default value of the limit will be 50. A single API request can fetch a maximum of 250 resources.
The optional int value indicates from which point the records will be fetched. The default value of from parameter is 0.
The optional string value determines the tasks's status. For example:
createdreceivedsuccessfailedcancelednotNowThe Devices Management endpoints provide functionality for managing devices in the system. These endpoints allow you to register new devices, retrieve existing devices' details, manage them, and remove them when they are no longer needed. All operations must be authenticated using a valid JSON Web Token (JWT) in the authorization header. All operations respect control over user access and roles within the platform.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"70200429-9646-4222-858a-f5a2ea2ebe03","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"8c8a2eff-eb02-445f-b56f-473898ec6cbe","type":"text/javascript","exec":[""]}}],"_postman_id":"25a4124f-8ca0-4737-ac13-4f588a5f26bb"},{"name":"Groups management","item":[{"name":"Get Groups list with details","event":[{"listen":"test","script":{"id":"64a0d90a-2af6-4c8a-80af-487ca1329368","exec":["pm.response.to.have.status(200);","","var group_name = pm.variables.get('GROUP_NAME');","","pm.test(\"Look for group id\", function() {"," for (let i = 0; i < pm.response.json().length; i++) {"," if(pm.response.json()[i].name === group_name) {"," pm.expect(pm.response.json()[i].id).not.equal(null);"," pm.environment.set(\"GROUP_ID\", pm.response.json()[i].id);"," }"," }","});"],"type":"text/javascript"}}],"id":"fcd4f75a-27aa-4a7c-b70a-f5edf680f262","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{}},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"https://{{SERVER}}/api/mdm/group","description":"The api/mdm/group endpoint returns a list of groups with their details.
This collection of endpoints enables the management of devices groups within the system. With these endpoints, you can create new groups, assign filters and retrieve information about specific groups. Similar to other API sections, all requests require a valid JSON Web Token (JWT) for authentication in the authorization header. All operations respect control over user access and roles within the platform.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"6f19aaaf-34a8-46df-a517-545ba22287b8","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"d0d7eadd-4a7a-46f7-8a99-e98cca03ff2c","type":"text/javascript","exec":[""]}}],"_postman_id":"6b3b81e8-e1b1-4155-85b0-237cb5998afc"},{"name":"Profiles management","item":[{"name":"Business documents","item":[{"name":"Get a list of Business documents profiles","event":[{"listen":"test","script":{"id":"0051adfc-551d-44b2-9588-6abaea5ac702","exec":["pm.response.to.have.status(200);","","var profile_name = pm.variables.get('BUSINESS_DOCUMENTS_PROFILE_NAME');","","pm.test(\"Look for business documents profile id\", function() {"," for (let i = 0; i < pm.response.json().length; i++) {"," if(pm.response.json()[i].name === profile_name) {"," pm.expect(pm.response.json()[i].id).not.equal(null);"," pm.environment.set(\"BUSINESS_DOCUMENTS_PROFILE_ID\", pm.response.json()[i].id);"," }"," }","});"],"type":"text/javascript"}}],"id":"f51a35af-ce34-48df-9bca-b6919844af7b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"https://{{SERVER}}/api/mdm/profile/documents","description":"This GET request allows you to list existing Business document profiles already created on a server.
\n","urlObject":{"protocol":"https","path":["api","mdm","profile","documents"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[{"id":"06c93395-07a8-43ef-853c-f740223d5280","name":"200 OK - Business documents profile(s) list","originalRequest":{"method":"GET","header":[],"url":"https://{{SERVER}}/api/mdm/profile/documents"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Tue, 18 Apr 2023 12:16:45 GMT"},{"key":"Permissions-Policy","value":"interest-cohort=()"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"uuid\": \"6cc5bf67-5e01-4442-907f-31c095996adc\",\n \"id\": 3,\n \"name\": \"Profile: Business documents\"\n }\n]"}],"_postman_id":"f51a35af-ce34-48df-9bca-b6919844af7b"},{"name":"Get Business documents profile details by profile id","event":[{"listen":"test","script":{"id":"fc9ce160-a5f7-44fc-9ba8-64c5984b20c2","exec":["pm.response.to.have.status(200);"],"type":"text/javascript"}}],"id":"279957fa-9651-49aa-a299-f4c7bd752297","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"https://{{SERVER}}/api/mdm/profile/documents/{{BUSINESS_DOCUMENTS_PROFILE_ID}}","description":"This GET request allows you to get all of the details from a particular Business documents profile. Use a response to build a body for a request to update the Business documents profile.
\n","urlObject":{"protocol":"https","path":["api","mdm","profile","documents","{{BUSINESS_DOCUMENTS_PROFILE_ID}}"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[{"id":"b066a7ad-2650-44f4-bcbf-e9e63468dbbf","name":"200 OK - Business documents profile with details","originalRequest":{"method":"GET","header":[],"url":"https://{{SERVER}}/api/mdm/profile/documents/{{BUSINESS_DOCUMENTS_PROFILE_ID}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Tue, 18 Apr 2023 12:18:25 GMT"},{"key":"Permissions-Policy","value":"interest-cohort=()"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"}],"cookie":[],"responseTime":null,"body":"{\n \"uuid\": \"6cc5bf67-5e01-4442-907f-31c095996adc\",\n \"id\": 3,\n \"name\": \"Profile: Business documents\",\n \"notifyChanges\": true,\n \"allowWifi\": true,\n \"allowMobileData\": true,\n \"defaultDownloadsDirectory\": false,\n \"files\": [\n {\n \"id\": \"0d4c91d6-9a18-4db5-b060-f4165d039511\",\n \"path\": \"/test1.txt\"\n },\n {\n \"id\": \"05833eec-13e0-4189-af11-82fb369c780e\",\n \"path\": \"/test2.txt\"\n }\n ]\n}"}],"_postman_id":"279957fa-9651-49aa-a299-f4c7bd752297"},{"name":"Upload a new file to the Business document profile","event":[{"listen":"test","script":{"id":"5a77a2e5-bc99-4e87-9e5f-0434f01c0d6c","exec":["pm.response.to.have.status(201);","","pm.environment.set(\"BUSINESS_DOCUMENTS_UPLOAD_ID\", pm.response.json().id);"],"type":"text/javascript"}}],"id":"44e9db64-76c6-4124-b055-ee548905afd8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"type","value":"other","type":"text","description":"The require string value which specifies a type of uploaded file. The' type' for the Business Documents profile should be specified as other.
The require string value which specifies a file path. Multiple files can be uploaded at one time.
This POST request allows you to upload a new file to the Business documents profile.
\n","urlObject":{"protocol":"https","path":["api","mdm","file"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[{"id":"63ea63bf-bb8e-4e7a-b5e0-f1c383e6a1b6","name":"201 Created - Upload id","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"type","value":"other","type":"text"},{"key":"file","type":"file","src":"/home/ajakubiec/Pobrane/test3.txt"}]},"url":"https://{{SERVER}}/api/mdm/file"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Tue, 18 Apr 2023 12:21:50 GMT"},{"key":"Permissions-Policy","value":"interest-cohort=()"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"1fad1db9-8f38-47df-a654-33f97c0ea376\"\n}"},{"id":"6bb304dc-732d-4c37-98ba-4821b47e21da","name":"400 Bad request - Validation failed. Required params or body are missing","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"type","value":"other","type":"text","disabled":true},{"key":"file","type":"file","src":"/home/ajakubiec/Pobrane/test3.txt"}]},"url":"https://{{SERVER}}/api/mdm/file"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Wed, 19 Apr 2023 10:19:08 GMT"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 400,\n \"message\": \"Validation Failed\",\n \"errors\": {\n \"children\": {\n \"type\": {\n \"errors\": [\n \"This value should not be empty.\"\n ]\n },\n \"file\": {\n \"errors\": [\n \"This value should not be empty.\"\n ]\n }\n },\n \"_extraFields\": []\n }\n}"},{"id":"fa65329b-4309-4076-a120-4af1d495693b","name":"413 Request Entity Too Large","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"type","value":"other","type":"text","description":"The require `string` value which specifies a type of uploaded file. The' type' for the Business Documents profile should be specified as `other`."},{"key":"file","type":"file","src":"/home/ajakubiec/Pobrane/Greenbone-Enterprise-TRIAL-22.04.6-VirtualBox.ova"},{"key":"file","type":"file","value":null}]},"url":"https://{{SERVER}}/api/mdm/file"},"status":"Request Entity Too Large","code":413,"_postman_previewlanguage":"html","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 19 Apr 2023 10:25:12 GMT"},{"key":"Content-Type","value":"text/html"},{"key":"Content-Length","value":"176"},{"key":"Connection","value":"close"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"}],"cookie":[],"responseTime":null,"body":"\n \nThis PUT request allows you to send updates to the Business documents profile. Build a request body using a required field. Remember to put all the upload ids and file names in the request body with each update request. In another way, the missed ids and filenames will be removed from the profile.
\n","urlObject":{"protocol":"https","path":["api","mdm","profile","documents","{{BUSINESS_DOCUMENTS_PROFILE_ID}}"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[{"id":"2eef8e09-1b33-4242-ba70-16d3a32470ce","name":"204 No Content - Success","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"notifyChanges\": true,\n \"allowWifi\": true,\n \"allowMobileData\": true,\n \"defaultDownloadsDirectory\": true,\n \"files\": [\n {\n \"id\": \"0d4c91d6-9a18-4db5-b060-f4165d039511\",\n \"path\": \"/test1.txt\"\n },\n {\n \"id\": \"05833eec-13e0-4189-af11-82fb369c780e\",\n \"path\": \"/test2.txt\"\n },\n {\n \"id\": \"1fad1db9-8f38-47df-a654-33f97c0ea376\",\n \"path\": \"/test3.txt\"\n }\n \n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://{{SERVER}}/api/mdm/profile/documents/{{BUSINESS_DOCUMENTS_PROFILE_ID}}"},"status":"No Content","code":204,"_postman_previewlanguage":"plain","header":[{"key":"Server","value":"nginx"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Tue, 18 Apr 2023 12:23:41 GMT"},{"key":"Permissions-Policy","value":"interest-cohort=()"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"}],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"552f795f-68a8-4625-9fdc-a5e3433c7ed9"}],"id":"e6d5fee6-2af4-4e90-af0e-ce6903ab5c1d","description":"This endpoint group delivers functionality for managing the Business documents profile. Using those endpoints, you can list Business document profiles and manage the files within them.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"224c7a82-5578-4a6f-8220-7c0f98de6e75","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"7b444aac-f757-44bd-a55e-6e74d3967cef","type":"text/javascript","exec":[""]}}],"_postman_id":"e6d5fee6-2af4-4e90-af0e-ce6903ab5c1d"},{"name":"Apple Business","item":[{"name":"Get a list of Apple Business profiles","id":"0c65db23-d0b4-4433-b09f-1326ad4e58de","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://{{SERVER}}/api/mdm/profile/dep","description":"Retrieves a list of Apple Business profiles available in the system.
\nThis endpoint returns the Apple Business profiles configured for device enrollment and management. It can be used to fetch all available profiles so they can be reviewed, selected, assigned, or otherwise managed in downstream operations.
\nRequest details:
\nMethod: GET
URL: https://{{SERVER}}/api/mdm/profile/dep
Request body:
\nExpected response:
\n200 OK with a response body containing the list of Apple Business profiles.This group of endpoints is designed to manage profiles within the system. You can retrieve the profile information and preferences. As with other API sections, requests must include a valid JSON Web Token (JWT) in the authorization header for authentication. All operations respect control over user access and roles within the platform.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"e57c6f05-ab01-4268-bf0c-2987cb657a9c","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"b05ba8b1-eee4-436f-9121-0f55bfe1399d","type":"text/javascript","exec":[""]}}],"_postman_id":"069ae9a0-7094-4708-9eeb-379147f73d16"},{"name":"System management","item":[{"name":"Get Notification list","id":"06e87fe3-1948-400a-a12b-fa6c78677fb1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"https://{{SERVER}}/api/mdm/notification","description":"This GET request lets you obtain a list of system notifications. You can fetch all notifications or filter them using available criteria.
\n","urlObject":{"protocol":"https","path":["api","mdm","notification"],"host":["{{SERVER}}"],"query":[{"disabled":true,"description":{"content":"The optional int value indicates the number of records the API must fetch. The default value of the limit will be 20. A single API request can fetch a maximum of 250 resources.
The optional int value indicates from which point the records will be fetched. The default value of from parameter is 0.
deviceSecurityStatusChanged\napplicationNoLongerAvailable\ndeviceApplicationReported\nazureSynchronizationErrors\nldapSynchronizationErrors\ndepServerForbidden\ndevicePasswordNotSet\nappleTermsNotAccepted\nandroidEnterpriseConfigurationUpdate\ndeviceLocationAvailability\ndeviceGeofencingTransition\nmtp\nazureAuthenticationFailed\ndepTokenExpired\nazureInsufficientAccessTokenRoles\nupdateProcessed\ndeviceActivated\ndeviceDeactivated\ndeviceLackOfContact\ndeviceLostModeStatusChanged\nazureUserUnassigned\nldapUserRemoved\napnCertificateExpiry\nazureExpiry\nadminApplicationsChanged\ndeviceSimChanged\nintegrityViolationChanged\ndeviceSimPinningStatusChanged\ndeviceUserChanged
\n","type":"text/plain"},"key":"type[]","value":"deviceSecurityStatusChanged"},{"disabled":true,"key":"createdAt","value":"2023-01-01"},{"disabled":true,"key":"acknowledged","value":"true"}],"variable":[]}},"response":[{"id":"4faae6a4-b429-41d0-8b16-41c6ec485210","name":"200 OK - Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://{{SERVER}}/api/mdm/notification","protocol":"https","host":["{{SERVER}}"],"path":["api","mdm","notification"],"query":[{"key":"limit","value":"50","description":"The optional `int` value indicates the number of records the API must fetch. The default value of the limit will be 20. A single API request can fetch a maximum of 250 resources.","disabled":true},{"key":"offset","value":"0","description":"The optional `int` value indicates from which point the records will be fetched. The default value of from parameter is 0.","disabled":true},{"key":"type[]","value":"deviceSecurityStatusChanged","description":"deviceSecurityStatusChanged\napplicationNoLongerAvailable\ndeviceApplicationReported\nazureSynchronizationErrors\nldapSynchronizationErrors\ndepServerForbidden\ndevicePasswordNotSet\nappleTermsNotAccepted\nandroidEnterpriseConfigurationUpdate\ndeviceLocationAvailability\ndeviceGeofencingTransition\nmtp\nazureAuthenticationFailed\ndepTokenExpired\nazureInsufficientAccessTokenRoles\nupdateProcessed\ndeviceActivated\ndeviceDeactivated\ndeviceLackOfContact\ndeviceLostModeStatusChanged\nazureUserUnassigned\nldapUserRemoved\napnCertificateExpiry\nazureExpiry\nadminApplicationsChanged\ndeviceSimChanged\nintegrityViolationChanged\ndeviceSimPinningStatusChanged\ndeviceUserChanged","disabled":true},{"key":"createdAt","value":"2023-01-01","disabled":true},{"key":"acknowledged","value":"true","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 20 Apr 2023 14:21:33 GMT"},{"key":"Permissions-Policy","value":"interest-cohort=()"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"}],"cookie":[],"responseTime":null,"body":"{\n \"items\": [\n {\n \"id\": \"a45c56e5-29c9-4799-b10a-2e21664b5f7b\",\n \"createdAt\": \"2023-04-20 14:54:35\",\n \"type\": \"deviceLostModeStatusChanged\",\n \"context\": {\n \"time\": \"2023-04-20T14:54:35.077+02:00\",\n \"types\": [\n \"device.lost_mode.reason.task\"\n ],\n \"device\": {\n \"id\": 3310,\n \"imei\": \"354001151306792\",\n \"user\": {\n \"id\": 1,\n \"uuid\": \"8e9968df-a6d5-4bbb-ad5f-6b0f527ad92f\",\n \"lastName\": \"Doe\",\n \"firstName\": \"John\"\n },\n \"model\": \"moto g(100)\",\n \"vendor\": \"MOTOROLA\",\n \"serialNumber\": \"ZY22BT348S\"\n }\n },\n \"acknowledgedAt\": null,\n \"acknowledgedBy\": null\n },\n {\n \"id\": \"3a17494a-9336-438c-be96-0556c0b791a5\",\n \"createdAt\": \"2023-04-20 03:40:48\",\n \"type\": \"androidEnterpriseConfigurationUpdate\",\n \"context\": {\n \"applications\": [\n \"com.android.chrome\"\n ]\n },\n \"acknowledgedAt\": null,\n \"acknowledgedBy\": null\n }\n ],\n \"limit\": 20,\n \"offset\": 0,\n \"total\": 2\n}"}],"_postman_id":"06e87fe3-1948-400a-a12b-fa6c78677fb1"}],"id":"9c4bb2dd-2cb5-4ed6-aa44-817e5cbe6018","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"941abb74-71eb-4de7-90af-ed9c90f77427","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"b7d8db85-0ad9-4f9c-a09e-0fbd6751afcc","type":"text/javascript","exec":[""]}}],"_postman_id":"9c4bb2dd-2cb5-4ed6-aa44-817e5cbe6018","description":""},{"name":"Devices info","item":[{"name":"Get warrnings","id":"82d38dd9-32b9-4389-91f7-0de857960f0e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://{{SERVER}}/api/mdm/warning?name[]=warning.lost_mode.status","description":"This GET request lets you obtain a list of gathered device warnings. You can fetch all notifications or filter them using available criteria.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":true,"source":{"_postman_id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","name":"PROGET API","type":"collection"}},"urlObject":{"protocol":"https","path":["api","mdm","warning"],"host":["{{SERVER}}"],"query":[{"key":"name[]","value":"warning.lost_mode.status"}],"variable":[]}},"response":[],"_postman_id":"82d38dd9-32b9-4389-91f7-0de857960f0e"}],"id":"88e17870-5d07-4f74-8526-952f1aa920bf","_postman_id":"88e17870-5d07-4f74-8526-952f1aa920bf","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":true,"source":{"_postman_id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","name":"PROGET API","type":"collection"}}},{"name":"Applications management","item":[{"name":"Get list off applications","id":"e3ff166f-2d65-4856-85c4-42008db7d0e5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://{{SERVER}}/app/application","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":true,"source":{"_postman_id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","name":"PROGET API","type":"collection"}},"urlObject":{"protocol":"https","path":["app","application"],"host":["{{SERVER}}"],"query":[{"disabled":true,"description":{"content":"The name of an application
\n","type":"text/plain"},"key":"name","value":"Proget"},{"disabled":true,"description":{"content":"The packakgeId of an application
\n","type":"text/plain"},"key":"packageId","value":"pl.proget.progetmdm"},{"disabled":true,"description":{"content":"device,file,external_resource,shop
\n","type":"text/plain"},"key":"origin","value":"shop"},{"disabled":true,"key":"system","value":"android"},{"disabled":true,"key":"limit","value":"50"},{"disabled":true,"key":"offset","value":"0"}],"variable":[]}},"response":[],"_postman_id":"e3ff166f-2d65-4856-85c4-42008db7d0e5"},{"name":"Get Android app managed configurations","id":"5ae33ddb-3020-4257-811c-cac3de6f80e6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://{{SERVER}}/app/application/{{APP_UUID}}/android-configuration","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":true,"source":{"_postman_id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","name":"PROGET API","type":"collection"}},"urlObject":{"protocol":"https","path":["app","application","{{APP_UUID}}","android-configuration"],"host":["{{SERVER}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"5ae33ddb-3020-4257-811c-cac3de6f80e6"}],"id":"bfc38dc3-73ed-4b6b-8e1b-f7cca7f8bf59","_postman_id":"bfc38dc3-73ed-4b6b-8e1b-f7cca7f8bf59","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]},"isInherited":true,"source":{"_postman_id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","id":"af3cbfe0-0a14-41f0-bd2e-ac525db29fa0","name":"PROGET API","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{TOKEN}}"}]}},"event":[{"listen":"prerequest","script":{"id":"35286c0a-272a-4b86-94fc-41c58d332040","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"2f641bae-f65f-4ff0-b91f-e1a6ee6fdeb5","type":"text/javascript","exec":[""]}}]}