Update Windows application configuration

PUT

/v1/organizations/:organizationId/mdm/windows/enterprise/applications/:winApplicationId

Update Windows application configuration

Required Permission: mdm.windows.application.update

Update Windows application configuration modifying source type and linked references for store, build, or asset deployment strategies.

Request

Add parameter in header authorization

Example: Authorization: Bearer <token>

organizationId string

required

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

winApplicationId string

required

Windows application identifier used for retrieving, updating, or deleting specific application configurations.

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

Body Params application/json

type string optional

Updated application source type modifying deployment strategy for existing application registration.

store build asset lastBuild lastGitBranchBuild lastGitTagBuild lastTagBuild

config object optional

Updated application configuration object modifying source-specific identifiers and filtering rules.

winStoreId string optional

Updated Microsoft Store application identifier for store-based deployment changes.

≤ 256 characters

buildId string optional

Updated build resource identifier for uploaded package deployment changes.

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

mdmAssetId string optional

Updated MDM asset identifier for asset library deployment changes.

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

applicationId string optional

Updated application resource identifier for dynamic build reference changes.

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

filter string optional

Updated filter expression for dynamic build selection criteria changes.

≤ 256 characters

{
    "type": "build",
    "config": {
        "winStoreId": "9NBLGGH4NNS1",
        "buildId": "507f1f77bcf86cd7994390ee",
        "mdmAssetId": "507f1f77bcf86cd7994390ff",
        "applicationId": "507f1f77bcf86cd799439100",
        "filter": "branch:production"
    }
}

Responses

200 Response application/json

status boolean optional

data object optional

id string optional

Unique identifier for this specific resource instance in the system following a standardized format enabling targeted operations, relationship mapping, and tracking across all platform endpoints and data stores.

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

organizationId string optional

Organization identifier indicating workspace ownership for access control and data isolation across multi-tenant environments.

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

winEnterpriseId string optional

Windows enterprise configuration identifier linking application to specific enrollment settings and device management context.

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

type string optional

Application source type specifying deployment strategy such as store, build, asset, or dynamic build references.

store build asset lastBuild lastGitBranchBuild lastGitTagBuild lastTagBuild

config object optional

Application configuration object containing source-specific identifiers and filtering rules for deployment.

winStoreId string optional

Microsoft Store application identifier for store-sourced deployments enabling catalog lookups.

≤ 256 characters

buildId string optional

Build resource identifier for uploaded package deployments linking to organizational build artifacts.

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

mdmAssetId string optional

MDM asset identifier for asset library deployments linking to file resources.

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

applicationId string optional

Application resource identifier for dynamic build references enabling version tracking.

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

filter string optional

Filter expression for dynamic build selection controlling which builds qualify for deployment.

≤ 256 characters

info object optional

Application metadata object containing name, version, publisher, and display information.

origin string optional

Application origin designation indicating whether sourced from library or external catalog.

library

version integer optional

Internal version counter for application changes enabling conflict detection and synchronization tracking.

≥ 0

updatedAt string optional

ISO 8601 timestamp indicating the last time this record was modified in the database useful for tracking changes, synchronization processes, and maintaining audit trails of all modifications.

Format: date-time

createdAt string optional

ISO 8601 timestamp indicating when this record was initially created in the database providing historical context, chronological ordering capabilities, and analytics for lifecycle tracking and reporting.

Format: date-time

{
    "status": true,
    "data": {
        "id": "507f1f77bcf86cd799439011",
        "organizationId": "507f1f77bcf86cd799439022",
        "winEnterpriseId": "507f1f77bcf86cd799439033",
        "type": "store",
        "config": {
            "winStoreId": "9WZDNCRFHVJL",
            "buildId": "507f1f77bcf86cd799439044",
            "mdmAssetId": "507f1f77bcf86cd799439055",
            "applicationId": "507f1f77bcf86cd799439066",
            "filter": "branch:main"
        },
        "info": {
            "name": "Microsoft Teams",
            "version": "1.5.0",
            "publisher": "Microsoft Corporation"
        },
        "origin": "library",
        "version": 3,
        "updatedAt": "2026-02-10T14: 30: 00.000Z",
        "createdAt": "2025-11-20T09: 00: 00.000Z"
    }
}

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