Update macOSLobApp
Namespace: microsoft.graph
Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.
Update the properties of a macOSLobApp object.
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
PATCH /deviceAppManagement/mobileApps/{mobileAppId}
Request headers
Header | Value |
---|---|
Authorization | Bearer <token> Required. |
Accept | application/json |
Request body
In the request body, supply a JSON representation for the macOSLobApp object.
The following table shows the properties that are required when you create the macOSLobApp.
Property | Type | Description |
---|---|---|
id | String | Key of the entity. Inherited from mobileApp |
displayName | String | The admin provided or imported title of the app. Inherited from mobileApp |
description | String | The description of the app. Inherited from mobileApp |
publisher | String | The publisher of the app. Inherited from mobileApp |
largeIcon | mimeContent | The large icon, to be displayed in the app details and used for upload of the icon. Inherited from mobileApp |
createdDateTime | DateTimeOffset | The date and time the app was created. Inherited from mobileApp |
lastModifiedDateTime | DateTimeOffset | The date and time the app was last modified. Inherited from mobileApp |
isFeatured | Boolean | The value indicating whether the app is marked as featured by the admin. Inherited from mobileApp |
privacyInformationUrl | String | The privacy statement Url. Inherited from mobileApp |
informationUrl | String | The more information Url. Inherited from mobileApp |
owner | String | The owner of the app. Inherited from mobileApp |
developer | String | The developer of the app. Inherited from mobileApp |
notes | String | Notes for the app. Inherited from mobileApp |
publishingState | mobileAppPublishingState | The publishing state for the app. The app cannot be assigned unless the app is published. Inherited from mobileApp. Possible values are: notPublished , processing , published . |
committedContentVersion | String | The internal committed content version. Inherited from mobileLobApp |
fileName | String | The name of the main Lob application file. Inherited from mobileLobApp |
size | Int64 | The total size, including all uploaded files. Inherited from mobileLobApp |
bundleId | String | The primary bundleId of the package. |
minimumSupportedOperatingSystem | macOSMinimumOperatingSystem | ComplexType macOSMinimumOperatingSystem that indicates the minimum operating system applicable for the application. |
buildNumber | String | The build number of the package. This should match the package CFBundleShortVersionString of the .pkg file. |
versionNumber | String | The version number of the package. This should match the package CFBundleVersion in the packageinfo file. |
childApps | macOSLobChildApp collection | List of ComplexType macOSLobChildApp objects. Represents the apps expected to be installed by the package. |
md5HashChunkSize | Int32 | The chunk size for MD5 hash. This is '0' or empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file. |
md5Hash | String collection | The MD5 hash codes. This is empty if the package was uploaded directly. If the Intune App Wrapping Tool is used to create a .intunemac, this value can be found inside the Detection.xml file. |
ignoreVersionDetection | Boolean | When TRUE, indicates that the app's version will NOT be used to detect if the app is installed on a device. When FALSE, indicates that the app's version will be used to detect if the app is installed on a device. Set this to true for apps that use a self update feature. |
installAsManaged | Boolean | When TRUE, indicates that the app will be installed as managed (requires macOS 11.0 and other managed package restrictions). When FALSE, indicates that the app will be installed as unmanaged. |
Response
If successful, this method returns a 200 OK
response code and an updated macOSLobApp object in the response body.
Example
Request
Here is an example of the request.
PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps/{mobileAppId}
Content-type: application/json
Content-length: 1523
{
"@odata.type": "#microsoft.graph.macOSLobApp",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"publishingState": "processing",
"committedContentVersion": "Committed Content Version value",
"fileName": "File Name value",
"size": 4,
"bundleId": "Bundle Id value",
"minimumSupportedOperatingSystem": {
"@odata.type": "microsoft.graph.macOSMinimumOperatingSystem",
"v10_7": true,
"v10_8": true,
"v10_9": true,
"v10_10": true,
"v10_11": true,
"v10_12": true,
"v10_13": true,
"v10_14": true,
"v10_15": true,
"v11_0": true,
"v12_0": true,
"v13_0": true
},
"buildNumber": "Build Number value",
"versionNumber": "Version Number value",
"childApps": [
{
"@odata.type": "microsoft.graph.macOSLobChildApp",
"bundleId": "Bundle Id value",
"buildNumber": "Build Number value",
"versionNumber": "Version Number value"
}
],
"md5HashChunkSize": 0,
"md5Hash": [
"Md5Hash value"
],
"ignoreVersionDetection": true,
"installAsManaged": true
}
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: 1695
{
"@odata.type": "#microsoft.graph.macOSLobApp",
"id": "7be9250a-250a-7be9-0a25-e97b0a25e97b",
"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",
"publishingState": "processing",
"committedContentVersion": "Committed Content Version value",
"fileName": "File Name value",
"size": 4,
"bundleId": "Bundle Id value",
"minimumSupportedOperatingSystem": {
"@odata.type": "microsoft.graph.macOSMinimumOperatingSystem",
"v10_7": true,
"v10_8": true,
"v10_9": true,
"v10_10": true,
"v10_11": true,
"v10_12": true,
"v10_13": true,
"v10_14": true,
"v10_15": true,
"v11_0": true,
"v12_0": true,
"v13_0": true
},
"buildNumber": "Build Number value",
"versionNumber": "Version Number value",
"childApps": [
{
"@odata.type": "microsoft.graph.macOSLobChildApp",
"bundleId": "Bundle Id value",
"buildNumber": "Build Number value",
"versionNumber": "Version Number value"
}
],
"md5HashChunkSize": 0,
"md5Hash": [
"Md5Hash value"
],
"ignoreVersionDetection": true,
"installAsManaged": true
}
Feedback
Submit and view feedback for