---
title: "Create a new user catalog"
method: POST
path: "/api/v1/catalog/catalogs/"
tags: ["catalogs"]
---

# Create a new user catalog

`POST /api/v1/catalog/catalogs/`

Create a new user catalog

Required Query Parameters:
- **name**: The name of the new catalog


Returns:
- **UserCatalog**: The new user catalog

## Query parameters

- `name` string, required

## Response `201`

The new user catalog was created

- UserCatalog
  - `id` integer, required
  - `name` string, required
  - `created_at` string, date-time, required

## Other responses

- `409` — The catalog name already exists
- `422` — The catalog name is invalid

## Changes

- **2026-07-23** `05d6283fc201` — 1 warning
  - changed the pattern of the `query` request parameter `name` from `[a-zA-Z0-9\-_]{3,64}` to `^[a-zA-Z0-9\-_]{3,63}$`
- **2026-03-18** `b99206a49d27` — 1 warning
  - removed the optional property `owner_handle` from the response with the `201` status
- **2025-07-23** `29c059f1823a` — 1 info
  - the endpoint scheme security `HTTPBasic` was added to the API
- **2025-03-19** `dcd958492a63` — 2 info
  - api tag `catalogs` added
  - api tag `user_catalogs` removed
- **2024-10-08** `3794b64a27fa` — 1 info
  - added the optional property `owner_handle` to the response with the `201` status

[Full history](https://skmtc.dev/flox/apis/floxhub-catalog-server/changes/api/v1/catalog/catalogs/post.md)

---

[API](https://skmtc.dev/flox/apis/floxhub-catalog-server.md) · [All operations](https://skmtc.dev/flox/apis/floxhub-catalog-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flox/floxhub-catalog-server/revisions/8ec561551880/schema)