Update Apple application configuration

PUT

/v1/organizations/:organizationId/mdm/apple/enterprise/applications/:admApplicationId

Update Apple application configuration

Required Permission: mdm.apple.application.update

Updates the configuration, settings, and deployment policies for an existing Apple enterprise application.

Request

Add parameter in header authorization

Example: Authorization: Bearer <token>

organizationId string

required

Unique identifier for organization managing Apple enterprise application deployments and configurations.

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

admApplicationId string

required

Unique identifier for Apple enterprise application configuration within organizational MDM deployment.

Match pattern: ^[a-fA-F0-9]{24}$

Body Params application/json

type string optional

Application source type specifying build selection strategy for enterprise deployment and version management.

store build asset lastBuild lastGitBranchBuild lastGitTagBuild lastTagBuild

config object optional

Configuration object defining application source and version selection strategy for enterprise deployment.

appStoreId string optional

Apple App Store numeric application identifier for downloading public applications to managed devices.

≤ 256 characters

country string optional

ISO 3166-1 alpha-2 country code for App Store region-specific application availability and pricing.

≤ 2 characters

buildId string optional

Specific build identifier for application deployment when using direct build reference configuration.

Match pattern: ^[a-fA-F0-9]{24}$

mdmAssetId string optional

MDM asset identifier for deploying enterprise private application when using asset reference configuration.

Match pattern: ^[a-fA-F0-9]{24}$

applicationId string optional

Application identifier for deploying specific app version when using application reference configuration.

Match pattern: ^[a-fA-F0-9]{24}$

filter string optional

Build selection filter criteria for automatic version selection when using dynamic build strategies.

≤ 256 characters

os string optional

Target operating system platform for application deployment specifying iOS or macOS device compatibility.

ios macos

scripts object optional

Shell script collection for macOS application lifecycle management including installation and compliance automation.

preInstall string optional

Shell script executed before macOS application installation for environment preparation and validation.

postInstall string optional

Shell script executed after macOS application installation for configuration and cleanup tasks.

audit string optional

Shell script executed to verify macOS application installation state and compliance requirements.

enforce string optional

Shell script executed to remediate macOS application state when audit script detects non-compliance.

runner string optional

Shell script defining custom execution wrapper for macOS application lifecycle management.

{
    "type": "build",
    "config": {
        "appStoreId": "1234567890",
        "country": "US",
        "buildId": "698f22bb18f11470ce02da30",
        "mdmAssetId": "698f22bb18f11470ce02da30",
        "applicationId": "698f22bb18f11470ce02da30",
        "filter": "production"
    },
    "os": "ios",
    "scripts": {
        "preInstall": "#!/bin/bash\necho \"Preparing installation...\"",
        "postInstall": "#!/bin/bash\necho \"Installation complete\"",
        "audit": "#!/bin/bash\nif [ -d \"/Applications/MyApp.app\" ]; then exit 0; fi",
        "enforce": "#!/bin/bash\nopen -a \"MyApp\"",
        "runner": "#!/bin/bash\nexec \"$@\""
    }
}

Responses

200 Response application/json

status boolean optional

data object optional

id string optional

Unique identifier for Apple enterprise application configuration within organizational MDM deployment.

Match pattern: ^[a-fA-F0-9]{24}$

organization string optional

Unique identifier for organization managing Apple enterprise application deployments and configurations.

Match pattern: ^[a-fA-F0-9]{24}$

admEnterprise string optional

Unique identifier for Apple Device Management enterprise enrollment binding application to MDM server.

Match pattern: ^[a-fA-F0-9]{24}$

type string optional

Application source type specifying build selection strategy for enterprise deployment and version management.

store build asset lastBuild lastGitBranchBuild lastGitTagBuild lastTagBuild

config object optional

Configuration object defining application source and version selection strategy for enterprise deployment.

appStoreId string optional

Apple App Store numeric application identifier for downloading public applications to managed devices.

≤ 256 characters

country string optional

ISO 3166-1 alpha-2 country code for App Store region-specific application availability and pricing.

≤ 2 characters

buildId string optional

Specific build identifier for application deployment when using direct build reference configuration.

Match pattern: ^[a-fA-F0-9]{24}$

mdmAssetId string optional

MDM asset identifier for deploying enterprise private application when using asset reference configuration.

Match pattern: ^[a-fA-F0-9]{24}$

applicationId string optional

Application identifier for deploying specific app version when using application reference configuration.

Match pattern: ^[a-fA-F0-9]{24}$

filter string optional

Build selection filter criteria for automatic version selection when using dynamic build strategies.

≤ 256 characters

os string optional

Target operating system platform for application deployment specifying iOS or macOS device compatibility.

ios macos

info object optional

Detailed application metadata including version information, assets, and deployment details for managed devices.

origin string optional

Application source origin indicating whether application comes from organization library or external catalog.

library

version integer optional

Sequential version number tracking Apple enterprise application configuration changes and synchronization state.

≥ 0

updatedAt string optional

Timestamp indicating when Apple enterprise application configuration was last modified or synchronized.

Format: date-time

createdAt string optional

Timestamp indicating when Apple enterprise application configuration was initially created in system.

Format: date-time

{
    "status": true,
    "data": {
        "id": "698f22bb18f11470ce02da30",
        "organization": "698f22bb18f11470ce02da30",
        "admEnterprise": "698f22bb18f11470ce02da30",
        "type": "build",
        "config": {
            "appStoreId": "1234567890",
            "country": "US",
            "buildId": "698f22bb18f11470ce02da30",
            "mdmAssetId": "698f22bb18f11470ce02da30",
            "applicationId": "698f22bb18f11470ce02da30",
            "filter": "production"
        },
        "os": "ios",
        "info": {},
        "origin": "library",
        "version": 5,
        "updatedAt": "2026-02-10T14: 22:00Z",
        "createdAt": "2026-01-15T10: 30:00Z"
    }
}

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"
    }
}