Contents

StatusAppManagedListAppObject

A dictionary that describes a declarative managed app.

Declaration

object StatusAppManagedListAppObject

Properties

NameTypeDescription
_removedboolean

If true, the system removed the app and only this key and the identifier key are present in the status item object.

config-stateStatusAppManagedListManagedConfigurationObject

The status of app or extension managed configurations. This key is only present when managed configurations are available for the managed app or any of its extensions.

declaration-identifierstring

The identifier of the declaration that controls the app.

external-version-idinteger

The app’s external version identifier. You can also retrieve this value from the App Store. For more information, see Apps and Books for Organizations.

If the current external version identifier of an app on the App Store doesn’t match the external version identifier reported by the device, there may be an app update available for the device.

identifier Requiredstring

The app’s bundle id, which is unique.

namestring

The name of the app.

reasons[StatusAppManagedListStatusReasonObject]

An array that contains additional details about the app state, including errors.

short-versionstring

The short version of the app.

statestring

The status of the app, which has the following possible values:

  • optional: The app is optional and the user has to trigger its installation.

  • queued: The system has started installation of the app.

  • not-present: Management of the app occurs after it is installed.

  • prompting-for-consent: The system is displaying a prompt to the user to proceed with app installation.

  • prompting-for-login: The system is displaying an App Store sign-in prompt to the user to allow app installation.

  • prompting-for-management: The system is displaying a prompt to the user to allow changing the installed app to a managed app.

  • downloading: The system is downloading the app.

  • installing: The system is installing the app.

  • managed: The app is installed and managed.

  • managed-but-uninstalled: The app is required, but the system hasn’t installed it. The app becomes managed if the system installs it again. If the user removes an optional app, its state is optional, not managed-but-uninstalled.

  • failed: The app install failed.

update-statestring

The update status of the app, which has the following possible values:

  • available: An update is available for the app.

  • prompting-for-update: The system is displaying a prompt to the user to proceed with app installation.

  • prompting-for-update-login: The system is displaying an App Store sign-in prompt to the user to allow app installation.

  • updating: The app is updating.

  • failed: The app update failed.

versionstring

The version of the app.

Topics

Objects