---
title: "Delete a user catalog"
method: DELETE
path: "/api/v1/catalog/catalogs/{catalog_name}"
tags: ["catalogs"]
---

# Delete a user catalog

`DELETE /api/v1/catalog/catalogs/{catalog_name}`

## Request

- The document declares no server URL.
- Auth: one of:
  - HTTP bearer
  - HTTP basic

Delete a user catalog.

Path Parameters:
- **catalog_name**: The name of catalog to delete

Returns:
- **None**

Note: This endpoint is not yet implemented and returns 501.

## Path parameters

- `catalog_name` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: The catalog name is invalid
- `501`: Deletion of user catalogs is not yet implemented

## Changes

- **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}$`
- **2025-07-25** `29c059f1823a`: 1 info
  - the endpoint scheme security `HTTPBasic` was added to the API
- **2025-03-20** `dcd958492a63`: 2 info
  - api tag `catalogs` added
  - api tag `user_catalogs` removed
- **2024-10-04** `00ece6bb6c91`: 2 info
  - the endpoint scheme security `HTTPBearer` was added to the API
  - the endpoint scheme security `HTTPBasic` was removed from the API
- **2024-09-17** `49bbb9914d80`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/flox/apis/floxhub-catalog-server/changes/api/v1/catalog/catalogs/:catalog_name/delete.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.dev/flox/apis/floxhub-catalog-server/revisions/6731453cd7cd?raw)