---
title: "Changes to Resolve a list of Package Groups"
method: POST
path: "/api/v1/catalog/resolve"
---

# Changes to Resolve a list of Package Groups

`POST /api/v1/catalog/resolve`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 23 of 53 revisions.

- **2026-08-27** `8ec561551880` — 5 breaking, 1 warning, 1 info
- **2026-08-19** `3541e86c7ef9` — 3 warning
- **2025-11-19** `e0ce91a85d95` — 12 warning
- **2025-07-23** `29c059f1823a` — 1 info
- **2025-06-06** `eff897b30ae2` — 1 warning, 1 info
- **2025-06-05** `820177159d98` — 2 warning, 4 info
- **2025-06-03** `2a00861f8e6b` — 1 info
- **2025-03-19** `dcd958492a63` — 1 breaking, 2 warning
- **2025-02-10** `b1a16c027df3` — 4 warning, 2 info
- **2025-01-15** `e11930b30d05` — 1 info
- **2024-11-25** `a6334b91d853` — 1 info
- **2024-11-20** `da0b62672ad1` — 1 info
- **2024-11-12** `2174eae7a1b7` — 1 info
- **2024-10-03** `00ece6bb6c91` — 1 warning, 1 info
- **2024-09-12** `49bbb9914d80` — 6 warning, 2 info
- **2024-06-18** `79def2a501be` — 2 breaking, 10 info
- **2024-06-13** `201fc251983f` — 2 breaking, 3 info
- **2024-06-06** `47fde694946e` — 3 breaking, 1 warning, 5 info
- **2024-05-02** `26f195045991` — 11 breaking, 3 warning, 2 info
- **2024-04-24** `0e6180566a8c` — 4 breaking, 1 warning
- **2024-04-19** `d255dc4054f0` — 3 breaking, 1 warning, 1 info
- **2024-04-17** `33d27da64c2d` — 9 breaking, 7 info
- **2024-04-11** `7ba31661b446` — 8 breaking, 13 warning, 7 info

## Changes

- **2026-08-27** `8ec561551880` — 5 breaking, 1 warning, 1 info
  - the `items/items/page` response's property type changed from `object` to no type for status `200`
  - removed the required property `items/items/page/complete` from the response with the `200` status
  - removed the required property `items/items/page/messages` from the response with the `200` status
  - removed the required property `items/items/page/page` from the response with the `200` status
  - removed the required property `items/items/page/url` from the response with the `200` status
  - removed the optional property `items/items/page/packages` from the response with the `200` status
  - added `#/components/schemas/CatalogPage` to the `items/items/page` response property `allOf` list for the response status `200`
- **2026-08-19** `3541e86c7ef9` — 3 warning
  - added the new `archived` enum value to the `items/items/candidate_pages/items/messages/items/type` response property for the response status `200`
  - added the new `archived` enum value to the `items/items/messages/items/type` response property for the response status `200`
  - added the new `archived` enum value to the `items/items/page/messages/items/type` response property for the response status `200`
- **2025-11-19** `e0ce91a85d95` — 12 warning
  - added the new `broken` enum value to the `items/items/candidate_pages/items/messages/items/type` response property for the response status `200`
  - added the new `broken` enum value to the `items/items/messages/items/type` response property for the response status `200`
  - added the new `broken` enum value to the `items/items/page/messages/items/type` response property for the response status `200`
  - added the new `insecure` enum value to the `items/items/candidate_pages/items/messages/items/type` response property for the response status `200`
  - added the new `insecure` enum value to the `items/items/messages/items/type` response property for the response status `200`
  - added the new `insecure` enum value to the `items/items/page/messages/items/type` response property for the response status `200`
  - added the new `unfree` enum value to the `items/items/candidate_pages/items/messages/items/type` response property for the response status `200`
  - added the new `unfree` enum value to the `items/items/messages/items/type` response property for the response status `200`
  - added the new `unfree` enum value to the `items/items/page/messages/items/type` response property for the response status `200`
  - added the new `version_not_found` enum value to the `items/items/candidate_pages/items/messages/items/type` response property for the response status `200`
  - added the new `version_not_found` enum value to the `items/items/messages/items/type` response property for the response status `200`
  - added the new `version_not_found` enum value to the `items/items/page/messages/items/type` response property for the response status `200`
- **2025-07-23** `29c059f1823a` — 1 info
  - the endpoint scheme security `HTTPBasic` was added to the API
- **2025-06-06** `eff897b30ae2` — 1 warning, 1 info
  - removed the optional property `items/items/additionl_pages` from the response with the `200` status
  - added the optional property `items/items/candidate_pages` to the response with the `200` status
- **2025-06-05** `820177159d98` — 2 warning, 4 info
  - added the new `resolution_logic` enum value to the `items/items/messages/items/type` response property for the response status `200`
  - added the new `resolution_logic` enum value to the `items/items/page/messages/items/type` response property for the response status `200`
  - added the new optional `query` request parameter `candidate_pages`
  - added the optional property `items/items/additionl_pages` to the response with the `200` status
  - removed the `resolution_trace` enum value from the `items/items/messages/items/type` response property for the response status `200`
  - removed the `resolution_trace` enum value from the `items/items/page/messages/items/type` response property for the response status `200`
- **2025-06-03** `2a00861f8e6b` — 1 info
  - the `allow_missing_builds` request property default value `false` was removed
- **2025-03-19** `dcd958492a63` — 1 breaking, 2 warning
  - the response property `items/items/page/packages/items/scrape_date` became nullable for the status `200`
  - added the new `change_in_version_format` enum value to the `items/items/messages/items/type` response property for the response status `200`
  - added the new `change_in_version_format` enum value to the `items/items/page/messages/items/type` response property for the response status `200`
- **2025-02-10** `b1a16c027df3` — 4 warning, 2 info
  - added the new `missing_builds` enum value to the `items/items/messages/items/type` response property for the response status `200`
  - added the new `missing_builds` enum value to the `items/items/page/messages/items/type` response property for the response status `200`
  - added the new `unacceptable_licenses` enum value to the `items/items/messages/items/type` response property for the response status `200`
  - added the new `unacceptable_licenses` enum value to the `items/items/page/messages/items/type` response property for the response status `200`
  - added the new optional request property `items/items/descriptors/items/allow_missing_builds`
  - added the required property `items/items/page/packages/items/missing_builds` to the response with the `200` status
- **2025-01-15** `e11930b30d05` — 1 info
  - added the required property `items/items/page/packages/items/pkg_path` to the response with the `200` status
- **2024-11-25** `a6334b91d853` — 1 info
  - added the optional property `items/items/page/packages/items/cache_uri` to the response with the `200` status
- **2024-11-20** `da0b62672ad1` — 1 info
  - the endpoint scheme security `HTTPBearer` was added to the API
- **2024-11-12** `2174eae7a1b7` — 1 info
  - added the optional property `items/items/page/packages/items/catalog` to the response with the `200` status
- **2024-10-03** `00ece6bb6c91` — 1 warning, 1 info
  - added the new `invalid` enum value to the `items/items/page/packages/items/system` response property for the response status `200`
  - added the new `invalid` enum value to the request property `items/items/descriptors/items/systems/items/`
- **2024-09-12** `49bbb9914d80` — 6 warning, 2 info
  - added the new `attr_path_not_found.not_found_for_all_systems` enum value to the `items/items/messages/items/type` response property for the response status `200`
  - added the new `attr_path_not_found.not_found_for_all_systems` enum value to the `items/items/page/messages/items/type` response property for the response status `200`
  - added the new `attr_path_not_found.not_in_catalog` enum value to the `items/items/messages/items/type` response property for the response status `200`
  - added the new `attr_path_not_found.not_in_catalog` enum value to the `items/items/page/messages/items/type` response property for the response status `200`
  - added the new `attr_path_not_found.systems_not_on_same_page` enum value to the `items/items/messages/items/type` response property for the response status `200`
  - added the new `attr_path_not_found.systems_not_on_same_page` enum value to the `items/items/page/messages/items/type` response property for the response status `200`
  - added the new optional request property `items/items/descriptors/items/allow_insecure`
  - added the required property `items/items/page/packages/items/insecure` to the response with the `200` status
- **2024-06-18** `79def2a501be` — 2 breaking, 10 info
  - the `items/items/messages/items/` response's property type changed from no type to `object` for status `200`
  - the `items/items/page/messages/items/` response's property type changed from no type to `object` for status `200`
  - removed `#/components/schemas/ResolutionMessageGeneral, #/components/schemas/ResolutionAttrPathNotFound, #/components/schemas/ResolutionConstraintsTooTight` from the `items/items/messages/items/` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/ResolutionMessageGeneral, #/components/schemas/ResolutionAttrPathNotFound, #/components/schemas/ResolutionConstraintsTooTight` from the `items/items/page/messages/items/` response property `oneOf` list for the response status `200`
  - added the required property `items/items/messages/items/context` to the response with the `200` status
  - added the required property `items/items/messages/items/level` to the response with the `200` status
  - added the required property `items/items/messages/items/message` to the response with the `200` status
  - added the required property `items/items/messages/items/type` to the response with the `200` status
  - added the required property `items/items/page/messages/items/context` to the response with the `200` status
  - added the required property `items/items/page/messages/items/level` to the response with the `200` status
  - added the required property `items/items/page/messages/items/message` to the response with the `200` status
  - added the required property `items/items/page/messages/items/type` to the response with the `200` status
- **2024-06-13** `201fc251983f` — 2 breaking, 3 info
  - added `#/components/schemas/ResolutionMessageGeneral, #/components/schemas/ResolutionAttrPathNotFound, #/components/schemas/ResolutionConstraintsTooTight` to the `items/items/messages/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/ResolutionMessageGeneral, #/components/schemas/ResolutionAttrPathNotFound, #/components/schemas/ResolutionConstraintsTooTight` to the `items/items/page/messages/items/` response property `oneOf` list for the response status `200`
  - removed the non-success response with the status `406`
  - removed `#/components/schemas/ResolutionMessageGeneral-Input, #/components/schemas/ResolutionAttrPathNotFound-Input, #/components/schemas/ResolutionConstraintsTooTight-Input` from the `items/items/messages/items/` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/ResolutionMessageGeneral-Input, #/components/schemas/ResolutionAttrPathNotFound-Input, #/components/schemas/ResolutionConstraintsTooTight-Input` from the `items/items/page/messages/items/` response property `anyOf` list for the response status `200`
- **2024-06-06** `47fde694946e` — 3 breaking, 1 warning, 5 info
  - added the new required request property `items/items/descriptors/items/systems`
  - removed the required property `items/items/pages` from the response with the `200` status
  - removed the required property `items/items/system` from the response with the `200` status
  - removed the request property `items/items/system`
  - added the new optional request property `items/items/descriptors/items/allow_broken`
  - added the new optional request property `items/items/descriptors/items/allow_unfree`
  - added the new optional request property `items/items/descriptors/items/allowed_licenses`
  - added the optional property `items/items/page` to the response with the `200` status
  - added the required property `items/items/messages` to the response with the `200` status
- **2024-05-02** `26f195045991` — 11 breaking, 3 warning, 2 info
  - added the new required request property `items/items/descriptors/items/attr_path`
  - added the new required request property `items/items/descriptors/items/install_id`
  - removed `subschema #1` from the `items/items/descriptors/items/derivation` request property `anyOf` list
  - removed `subschema #1` from the `items/items/descriptors/items/version` request property `anyOf` list
  - removed `subschema #1` from the `items/items/stability` request property `anyOf` list
  - the `items/items/descriptors/items/derivation` request property type changed from no type to `string`
  - the `items/items/descriptors/items/version` request property type changed from no type to `string`
  - the `items/items/stability` request property type changed from no type to `string`
  - the `items/items/pages/items/packages` response's property type changed from no type to `array` for status `200`
  - removed the required property `status_code` from the response with the `406` status
  - removed the required property `status_code` from the response with the `422` status
  - removed the request property `items/items/descriptors/items/name`
  - removed the request property `items/items/descriptors/items/pkgPath`
  - removed the request property `items/items/descriptors/items/semver`
  - added the new optional request property `items/items/descriptors/items/allow_pre_releases`
  - removed `subschema #1` from the `items/items/pages/items/packages` response property `anyOf` list for the response status `200`
- **2024-04-24** `0e6180566a8c` — 4 breaking, 1 warning
  - added the new required request property `items/items/descriptors/items/pkgPath`
  - response property `items/items/pages/items/packages/anyOf[subschema #1]/items/outputs` list-of-types was widened by adding types `array` to media type `application/json` of response `200`
  - the `items/items/pages/items/packages/anyOf[subschema #1]/items/outputs/anyOf[subschema #1]/` response's property type changed from `object` to `array` for status `200`
  - the `items/items/pages/items/packages/anyOf[subschema #1]/items/outputs_to_install/anyOf[subschema #1]/items/` response's property type changed from no type to `string` for status `200`
  - removed the request property `items/items/descriptors/items/pkgpath`
- **2024-04-19** `d255dc4054f0` — 3 breaking, 1 warning, 1 info
  - added the new required request property `items/items/descriptors/items/pkgpath`
  - the response property `items/items/pages/items/packages/anyOf[subschema #1]/items/unfree` became nullable for the status `200`
  - the `items/items/pages/items/packages/anyOf[subschema #1]/items/unfree` response's property type changed from `boolean` to no type for status `200`
  - removed the request property `items/items/descriptors/items/pkgPath`
  - added `subschema #1` to the `items/items/pages/items/packages/anyOf[subschema #1]/items/unfree` response property `anyOf` list for the response status `200`
- **2024-04-17** `33d27da64c2d` — 9 breaking, 7 info
  - the response property `items/items/pages/items/packages/anyOf[subschema #1]/items/description` became nullable for the status `200`
  - the response property `items/items/pages/items/packages/anyOf[subschema #1]/items/license` became nullable for the status `200`
  - the response property `items/items/pages/items/packages/anyOf[subschema #1]/items/stabilities` became nullable for the status `200`
  - the `detail` response's property type changed from `array` to `string` for status `422`
  - the `items/items/pages/items/packages/anyOf[subschema #1]/items/description` response's property type changed from `string` to no type for status `200`
  - the `items/items/pages/items/packages/anyOf[subschema #1]/items/license` response's property type changed from `string` to no type for status `200`
  - the `items/items/pages/items/packages/anyOf[subschema #1]/items/rev_date` response's property type changed from `integer` to `string`, and format from no format to `date-time` for status `200`
  - the `items/items/pages/items/packages/anyOf[subschema #1]/items/scrape_date` response's property type changed from `integer` to `string`, and format from no format to `date-time` for status `200`
  - the `items/items/pages/items/packages/anyOf[subschema #1]/items/stabilities` response's property type changed from `array` to no type for status `200`
  - added the new optional request property `items/items/stability`
  - added the non-success response with the status `406`
  - added `subschema #1` to the `items/items/pages/items/packages/anyOf[subschema #1]/items/description` response property `anyOf` list for the response status `200`
  - added `subschema #1` to the `items/items/pages/items/packages/anyOf[subschema #1]/items/license` response property `anyOf` list for the response status `200`
  - added `subschema #1` to the `items/items/pages/items/packages/anyOf[subschema #1]/items/stabilities` response property `anyOf` list for the response status `200`
  - the response property `detail` became required for the status `422`
  - added the required property `status_code` to the response with the `422` status
- **2024-04-11** `7ba31661b446` — 8 breaking, 13 warning, 7 info
  - added the new required request property `items/items/descriptors/items/name`
  - added the new required request property `items/items/descriptors/items/pkgPath`
  - added the new required request property `items/items/system`
  - the `items/items/descriptors/items/derivation` request property type changed from `string` to no type
  - the `items/items/descriptors/items/version` request property type changed from `string` to no type
  - the response property `detail` became optional for the status `422`
  - the `detail` response's property type changed from `string` to `array` for status `422`
  - removed the required property `items/items/messages` from the response with the `200` status
  - deleted the `query` request parameter `candidate_pages`
  - removed the request property `items/items/descriptors/items/allow_broken`
  - removed the request property `items/items/descriptors/items/allow_insecure`
  - removed the request property `items/items/descriptors/items/allow_missing_builds`
  - removed the request property `items/items/descriptors/items/allow_pre_releases`
  - removed the request property `items/items/descriptors/items/allow_unfree`
  - removed the request property `items/items/descriptors/items/allowed_licenses`
  - removed the request property `items/items/descriptors/items/attr_path`
  - removed the request property `items/items/descriptors/items/install_id`
  - removed the request property `items/items/descriptors/items/systems`
  - removed the request property `items/items/stability`
  - removed the optional property `items/items/candidate_pages` from the response with the `200` status
  - removed the optional property `items/items/page` from the response with the `200` status
  - the endpoint scheme security `HTTPBasic` was removed from the API
  - the endpoint scheme security `HTTPBearer` was removed from the API
  - added the new optional request property `items/items/descriptors/items/semver`
  - added `subschema #1` to the `items/items/descriptors/items/derivation` request property `anyOf` list
  - added `subschema #1` to the `items/items/descriptors/items/version` request property `anyOf` list
  - added the required property `items/items/pages` to the response with the `200` status
  - added the required property `items/items/system` to the response with the `200` status

---

[Operation](https://skmtc.dev/flox/apis/floxhub-catalog-server/docs/api/v1/catalog/resolve/post.md) · [API](https://skmtc.dev/flox/apis/floxhub-catalog-server.md) · [Page](https://skmtc.dev/flox/apis/floxhub-catalog-server/changes/api/v1/catalog/resolve/post)
