---
title: "Changes to Perform actions on a catalog file"
method: POST
path: "/catalogs/{catalog_id}/file"
---

# Changes to Perform actions on a catalog file

`POST /catalogs/{catalog_id}/file`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 46 revisions.

- **2026-07-22** `e8e6b266ea29` — 8 info
- **2026-07-17** `9abb9bf6d3bf` — 1 info
- **2026-06-25** `7ed7a764efd9` — 1 info
- **2026-02-24** `3c57979a295f` — 1 info
- **2026-02-19** `07f53972fdd7` — 1 breaking

## Changes

- **2026-07-22** `e8e6b266ea29` — 8 info
  - api operation id `catalogFile` was added
  - added optional request body
  - the `query` request parameter `file` became optional
  - the `query` request parameter `task` became optional
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `500`
- **2026-07-17** `9abb9bf6d3bf` — 1 info
  - removed the non-success response with the status `400`
- **2026-06-25** `7ed7a764efd9` — 1 info
  - added the non-success response with the status `400`
- **2026-02-24** `3c57979a295f` — 1 info
  - endpoint added
- **2026-02-19** `07f53972fdd7` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/ampache/apis/ampache-rest-api/docs/catalogs/:catalog_id/file/post.md) · [API](https://skmtc.dev/ampache/apis/ampache-rest-api.md) · [Page](https://skmtc.dev/ampache/apis/ampache-rest-api/changes/catalogs/:catalog_id/file/post)