You are here: Home > API Reference > UEM > Configurations > Update MDM configurations

Update MDM configurations

Required Permission: mdm.global.configurations.update

Creates or replaces the MDM integration credentials for the organization.

PUT
https://api.applivery.io/v1/organizations/{organizationId}/mdm/configurations 
curl -X PUT "https://api.applivery.io/v1/organizations/{organizationId}/mdm/configurations" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "entraId": {
    "tenantId": "string",
    "clientId": "string",
    "clientSecret": "string"
  }
}'
const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/mdm/configurations", {
  method: "PUT",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "entraId": {
      "tenantId": "string",
      "clientId": "string",
      "clientSecret": "string"
    }
  }),
});

const data = await response.json();
import requests

response = requests.put(
    "https://api.applivery.io/v1/organizations/{organizationId}/mdm/configurations",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
    json={
      "entraId": {
        "tenantId": "string",
        "clientId": "string",
        "clientSecret": "string"
      }
    },
)

data = response.json()

Request

Send your API key in the request header authorization
Example: Authorization: Bearer <token>

organizationId string
required
Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

Body Params application/json
entraId object required
Microsoft Entra ID integration settings containing credentials required to authenticate against Microsoft Graph API for device compliance sync.
tenantId string required
Microsoft Entra ID tenant identifier representing the Azure Active Directory directory used for authentication and device management.
≤ 256 characters
clientId string required
Application client identifier registered in Microsoft Entra ID granting access to Microsoft Graph API on behalf of the organization.
≤ 256 characters
clientSecret string optional
Application client secret used to authenticate against Microsoft Entra ID. Always masked in API responses for security purposes.
≤ 256 characters
{
    "entraId": {
        "tenantId": "string",
        "clientId": "string",
        "clientSecret": "string"
    }
}

Responses

200 Response application/json
status boolean required
data object required
id string required
MDM configurations unique identifier used for database references, API responses, and internal system operations throughout the platform.
Match pattern: ^[a-fA-F0-9]{24}$
organizationId string required
Organization unique identifier linking MDM configurations to the owning workspace for access control and resource isolation.
Match pattern: ^[a-fA-F0-9]{24}$
entraId object required
Microsoft Entra ID integration settings containing credentials required to authenticate against Microsoft Graph API for device compliance sync.
tenantId string required
Microsoft Entra ID tenant identifier representing the Azure Active Directory directory used for authentication and device management.
≤ 256 characters
clientId string required
Application client identifier registered in Microsoft Entra ID granting access to Microsoft Graph API on behalf of the organization.
≤ 256 characters
clientSecret string optional
Application client secret used to authenticate against Microsoft Entra ID. Always masked in API responses for security purposes.
≤ 256 characters
updatedAt string required
Timestamp of the most recent update to the MDM configurations record reflecting the last modification date and time.
createdAt string required
Timestamp indicating when the MDM configurations record was first created in the system.
{
    "status": true,
    "data": {
        "id": "string",
        "organizationId": "string",
        "entraId": {
            "tenantId": "string",
            "clientId": "string",
            "clientSecret": "string"
        },
        "updatedAt": "string",
        "createdAt": "string"
    }
}
401 Response application/json
status boolean optional
false
error object optional
code number optional
4004
message string optional
Invalid Token
{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}
404 Response application/json
status boolean optional
false
error object optional
code number optional
3001
message string optional
Entity not found
{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}
Was this page helpful?