Skip to content

[API] Add multiple custom packages for the same software title in the same fleet - #48265

Merged
marko-lisica merged 4 commits into
docs-v4.90.0from
28108-api-changes
Jul 1, 2026
Merged

marko-lisica merged 4 commits into
docs-v4.90.0from
28108-api-changes

Conversation

@marko-lisica

@marko-lisica marko-lisica commented Jun 25, 2026 •

Copy link
Copy Markdown
Member

@claude claude Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Claude Code Review

This repository is configured for manual code reviews. Comment @claude review to trigger a review and subscribe this PR to future pushes, or @claude review once for a one-time review.

Tip: disable this comment in your organization's Code Review settings.

Comment thread docs/REST API/rest-api.md Outdated
Comment thread docs/REST API/rest-api.md

@marko-lisica marko-lisica Jun 25, 2026 •

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Dev notes

  • Add a packages array to the List software (GET /api/v1/fleet/software/titles) and Get software (GET /api/v1/fleet/software/titles/:id) responses. The array lists all packages added for a title.
    • GET /api/v1/fleet/software/titles: Don't include last_install and last_uninstall fields, as those are only relevant for the host.
  • software_package is kept for backwards compatibility and it contains the oldest (first added) package.
  • Per-package self_service, categories, and labels (labels_include_any, labels_exclude_any, labels_include_all.
  • GET /api/v1/fleet/hosts/:id/software
    • Keep the software_package object in the response. If multiple packages are added to the software title, it will include info about the package that is installed/available for install for that host.
    • In case there are multiple packages that are in scope on the host, we rely on the fallback (the package that is first added).

Comment thread docs/REST API/rest-api.md Outdated
Comment thread docs/REST API/rest-api.md Outdated
@marko-lisica
marko-lisica merged commit d626f6f into docs-v4.90.0 Jul 1, 2026
5 of 6 checks passed
@marko-lisica
marko-lisica deleted the 28108-api-changes branch July 1, 2026 11:17
cdcme added a commit that referenced this pull request Jul 9, 2026
… (#48975)

<!-- Add the related story/sub-task/bug number, like Resolves #123, or
remove if NA -->
**Related issue:** Resolves #48402 (story #28108)

Feature guide updates for [multiple custom packages for the same
software title](#28108) (Fleet
Premium, 4.90.0).

Docs-only PR against `docs-v4.90.0`, per Fleet convention that
`docs/`/`articles/` changes ship separately from code.

## Changes

- **`articles/deploy-software-packages.md`** — new "Add multiple
packages to a software title" section (up to 10 packages per title,
per-package labels/self-service/categories, first-added precedence on
overlap, setup-experience behavior, content-based dedupe, script-only
support), plus per-package clarifications to "Edit the package" and
"Delete the package".
- **`articles/automatic-software-install-in-fleet.md`** — note on the
per-package "Select package" dropdown (defaults to first-added; installs
within that package's label scope).
- **`articles/software-self-service.md`** — note that self-service is
set per package and the first-added package wins on overlap.

## Related reference docs (already merged to `docs-v4.90.0`)

- REST API `packages[]` — #48265
- GitOps `*.package.yml` list form — #48544

Guide copy was cross-checked against both.

## No changes needed

- **Audit log** (`docs/Contributing/reference/audit-logs.md`) — same
`added_software` activity, no new activity types.
- **Usage stats** (`articles/fleet-usage-statistics.md`) — no new usage
stats.
- **Fleet-maintained apps guide** — FMA titles stay
single-active/version-pinned and can't be mixed with custom packages, so
multi-package content does not apply.

# Checklist for submitter

- [x] QA'd all new/changed functionality manually (docs render/links
verified)

<!-- Docs-only PR: no changes file, no code/tests, no migrations, no
config settings, no fleetd changes. -->

---------

Co-authored-by: Marko Lisica <83164494+marko-lisica@users.noreply.github.com>

This branch was previously deployed

1 inactive deployment
Docker Hub — d26525a0 Deployed Jul 1, 2026 by marko-lisica via publish #95433
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants