Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Namespace: microsoft.graph
Important: Microsoft supports Intune /beta APIs, but they are subject to more frequent change. Microsoft recommends using version v1.0 when possible. Check an API's availability in version v1.0 using the Version selector.
Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.
This API is available in the following national cloud deployments.
| Global service | US Government L4 | US Government L5 (DOD) | China operated by 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
| Permission type | Permissions (from least to most privileged) |
|---|---|
| Delegated (work or school account) | DeviceManagementApps.ReadWrite.All |
| Delegated (personal Microsoft account) | Not supported. |
| Application | DeviceManagementApps.ReadWrite.All |
HTTP Request
POST /deviceAppManagement/mobileApps/createCatalogApp
Request headers
| Header | Value |
|---|---|
| Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
| Accept | application/json |
Request body
In the request body, supply JSON representation of the parameters.
The following table shows the parameters that can be used with this action.
| Property | Type | Description |
|---|---|---|
| mobileApp | mobileApp | |
| relationships | mobileAppRelationship collection | |
| mobileAppAssignments | mobileAppAssignment collection |
Response
If successful, this action returns a 200 OK response code and a mobileApp in the response body.
Example
Request
Here is an example of the request.
POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/createCatalogApp
Content-type: application/json
Content-length: 2890
{
"mobileApp": {
"@odata.type": "#microsoft.graph.mobileApp",
"id": "0177548a-548a-0177-8a54-77018a547701",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"uploadState": 11,
"publishingState": "processing",
"isAssigned": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"dependentAppCount": 1,
"supersedingAppCount": 3,
"supersededAppCount": 2
},
"relationships": [
{
"@odata.type": "#microsoft.graph.mobileAppRelationship",
"id": "7b4b5b14-5b14-7b4b-145b-4b7b145b4b7b",
"targetId": "Target Id value",
"targetDisplayName": "Target Display Name value",
"targetDisplayVersion": "Target Display Version value",
"targetPublisher": "Target Publisher value",
"targetPublisherDisplayName": "Target Publisher Display Name value",
"sourceId": "Source Id value",
"sourceDisplayName": "Source Display Name value",
"sourceDisplayVersion": "Source Display Version value",
"sourcePublisherDisplayName": "Source Publisher Display Name value",
"targetType": "parent"
}
],
"mobileAppAssignments": [
{
"@odata.type": "#microsoft.graph.mobileAppAssignment",
"id": "591620b7-20b7-5916-b720-1659b7201659",
"intent": "required",
"target": {
"@odata.type": "microsoft.graph.allLicensedUsersAssignmentTarget",
"deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value",
"deviceAndAppManagementAssignmentFilterType": "include"
},
"settings": {
"@odata.type": "microsoft.graph.winGetAppAssignmentSettings",
"notifications": "showReboot",
"restartSettings": {
"@odata.type": "microsoft.graph.winGetAppRestartSettings",
"gracePeriodInMinutes": 4,
"countdownDisplayBeforeRestartInMinutes": 6,
"restartNotificationSnoozeDurationInMinutes": 10
},
"installTimeSettings": {
"@odata.type": "microsoft.graph.winGetAppInstallTimeSettings",
"useLocalTime": true,
"deadlineDateTime": "2017-01-01T00:00:21.0378955-08:00"
}
},
"source": "policySets",
"sourceId": "Source Id value"
}
]
}
Response
Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1010
{
"value": {
"@odata.type": "#microsoft.graph.mobileApp",
"id": "0177548a-548a-0177-8a54-77018a547701",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"uploadState": 11,
"publishingState": "processing",
"isAssigned": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"dependentAppCount": 1,
"supersedingAppCount": 3,
"supersededAppCount": 2
}
}