[API/YAML] Deploy custom (in-house) iOS/iPadOS apps

[marko-lisica]

New PR: #33950

Related to:

• Use API to deploy in-house (enterprise) iOS/iPadOS package #30936

[marko-lisica]

Dev note

• When the user uploads an .ipa file type and they specify unsupported fields (install_script, uninstall_script, post_install_script, pre_install_query, categories, self_service, and automatic_install), Fleet will ignore them and won't throw an error or warning.

This means, that GitOps will run successfully. The .ipa package is added to Fleet without any of the unsupported fields.

[marko-lisica]

Fields that are not supported by .ipa package, should be null.

[marko-lisica]

software_package object returned by GET /api/v1/fleet/hosts/:id/software

"software_package": {
  "name": "MyCustomApp-1.12.ipa",
  "automatic_install_policies": null,
  "version": "1.12",
  "platform": "ios",
  "self_service": false,
  "icon_url": null,
  "last_install": {
    "install_uuid": "e4e31e89-7f43-4f18-8f12-d5dd09ee0d68",
    "installed_at": "2025-08-29T10:06:55.424525Z"
  },
  "last_uninstall": null,
  "package_url": null,
  "categories": null
}

[marko-lisica]

install_uuid is UUID of MDM command that is used to install .ipa

[rachaelshaw]

@marko-lisica should this still be merged to the 4.75 branch or is it pushed to 4.76?

[marko-lisica]

@marko-lisica should this still be merged to the 4.75 branch or is it pushed to 4.76?

We're not sure yet if this will go in 4.75. I would keep it open until next week. If we learn that we can't do it, then I'll close it.

[marko-lisica]

@rachaelshaw ^