---
title: "Changes to Create a new package in a user catalog"
method: POST
path: "/api/v1/catalog/catalogs/{catalog_name}/packages"
---

# Changes to Create a new package in a user catalog

`POST /api/v1/catalog/catalogs/{catalog_name}/packages`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 61 revisions.

- **2026-08-27** `8ec561551880`: 2 info
- **2026-07-28** `05d6283fc201`: 1 warning
- **2026-07-13** `0883f123cf55`: 1 warning
- **2026-03-09** `049c4d7c9f61`: 1 warning
- **2025-07-25** `29c059f1823a`: 1 warning, 1 info
- **2025-03-27** `5e278301f159`: 3 info
- **2025-03-20** `dcd958492a63`: 4 breaking, 4 info
- **2024-11-08** `0d707062a22e`: 2 info
- **2024-10-04** `00ece6bb6c91`: 1 info
- **2024-04-11** `7ba31661b446`: 1 breaking

## Changes

- **2026-08-27** `8ec561551880`: 2 info
  - added the optional property `lifecycle` to the response with the `200` status
  - added the optional property `lifecycle` to the response with the `201` status
- **2026-07-28** `05d6283fc201`: 1 warning
  - changed the pattern of the `path` request parameter `catalog_name` from `[a-zA-Z0-9\-_]{3,64}` to `^[a-zA-Z0-9\-_]{3,63}$`
- **2026-07-13** `0883f123cf55`: 1 warning
  - changed the pattern of the `query` request parameter `name` from `[a-zA-Z0-9.\-_]{1,128}` to `^[a-zA-Z0-9.\-_]{1,128}$`
- **2026-03-09** `049c4d7c9f61`: 1 warning
  - changed the pattern of the `query` request parameter `name` from `[a-zA-Z0-9.\-_]{3,128}` to `[a-zA-Z0-9.\-_]{1,128}`
- **2025-07-25** `29c059f1823a`: 1 warning, 1 info
  - changed the pattern of the `query` request parameter `name` from `[a-zA-Z0-9\.\-_]{3,128}` to `[a-zA-Z0-9.\-_]{3,128}`
  - the endpoint scheme security `HTTPBasic` was added to the API
- **2025-03-27** `5e278301f159`: 3 info
  - request property `original_url` deprecated
  - response property `original_url` deprecated
  - response property `original_url` deprecated
- **2025-03-20** `dcd958492a63`: 4 breaking, 4 info
  - the response property `original_url` became nullable for the status `200`
  - the response property `original_url` became nullable for the status `201`
  - the response property `original_url` became optional for the status `200`
  - the response property `original_url` became optional for the status `201`
  - api tag `catalogs` added
  - api tag `user_catalogs` removed
  - the request property `original_url` became nullable
  - the request property `original_url` became optional
- **2024-11-08** `0d707062a22e`: 2 info
  - api operation id `post_catalog_package_api_v1_catalog_catalogs__catalog_name__packages_post` removed and replaced with `create_catalog_package_api_v1_catalog_catalogs__catalog_name__packages_post`
  - added the success response with the status `200`
- **2024-10-04** `00ece6bb6c91`: 1 info
  - endpoint added
- **2024-04-11** `7ba31661b446`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/flox/apis/floxhub-catalog-server/docs/api/v1/catalog/catalogs/:catalog_name/packages/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/catalogs/:catalog_name/packages/post)