Viewing Plan Details

Technical Articles

Solution
Application
Content Type
Technical Documentation
Utilities & Services
ft:locale
en-US

You can troubleshoot your managed software updates deployments by retrieving the details contained in a plan. A plan is a singular request to update a computer or mobile device to a particular version. Only one plan can be active for a computer or mobile device at a time. For example, if you deploy a plan to a computer, you cannot deploy another plan to that same computer until the first plan has completed. Reading plan details can assist troubleshooting efforts by clarifying exactly what the contents of the command sent to the computer or mobile device are. You can retrieve managed software updates plan details in a computer or mobile device inventory record or by using the /v1/managed-software-updates/plans API endpoint. For more information on API endpoints, see Jamf Pro API Overview.

Example:
"planUuid": "6E47EF55-5318-494F-A09E-70F613E0AFD1",
      "device": {
        "deviceId": "1",
        "objectType": "COMPUTER",
        "href": "/v1/computers-inventory/1"
      },
      "updateAction": "DOWNLOAD_INSTALL",
      "versionType": "SPECIFIC_VERSION",
      "specificVersion": "12.6.1",
      "maxDeferrals": 5,
      "forceInstallLocalDateTime": "2023-12-25T21:09:31",
      "recipeId": "1",
      "status": {
        "state": "SchedulingScanForOSUpdates",
        "errorReasons": [
          "NO_UPDATES_AVAILABLE",
          "NOT_SUPERVISED"
        ]
      }