Register new Windows application

POST

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

Register new Windows application

Required Permission: mdm.windows.application.create

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,}))$

Body Params application/json

type string required

Application source type to configure specifying deployment strategy for the new application registration.

store build asset lastBuild lastGitBranchBuild lastGitTagBuild lastTagBuild

config object required

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

winStoreId string optional

Microsoft Store application identifier when type is store enabling catalog-based deployment.

≤ 256 characters

buildId string optional

Build resource identifier when type is build linking to uploaded package artifact.

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

mdmAssetId string optional

MDM asset identifier when type is asset linking to file resource in library.

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

applicationId string optional

Application resource identifier when type references dynamic builds enabling version tracking.

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

filter string optional

Filter expression for dynamic build types controlling which builds qualify for automatic deployment.

≤ 256 characters

{
    "type": "store",
    "config": {
        "winStoreId": "9WZDNCRFHVJL",
        "buildId": "507f1f77bcf86cd7994390bb",
        "mdmAssetId": "507f1f77bcf86cd7994390cc",
        "applicationId": "507f1f77bcf86cd7994390dd",
        "filter": "tag:v*"
    }
}

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

400 Response application/json

status boolean optional

false

error object optional

code number optional

5050

message string optional

Feature not allowed for you billing plan

{
    "status": false,
    "error": {
        "code": 5050,
        "message": "Feature not allowed for you billing plan"
    }
}

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