---
title: "Changes to Kick off a catalog task (add/clean/verify/gather art) for the selected catalog"
method: POST
path: "/catalogs/{catalog_id}/action"
---

# Changes to Kick off a catalog task (add/clean/verify/gather art) for the selected catalog

`POST /catalogs/{catalog_id}/action`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 46 revisions.

- **2026-07-22** `e8e6b266ea29` — 6 info
- **2026-07-17** `9abb9bf6d3bf` — 3 breaking, 5 info
- **2026-07-14** `aaf4166bdf3a` — 1 info
- **2026-07-06** `21e41c5adb1c` — 1 breaking
- **2026-06-25** `7ed7a764efd9` — 1 info
- **2026-02-24** `3c57979a295f` — 1 info
- **2026-02-19** `07f53972fdd7` — 1 breaking

## Changes

- **2026-07-22** `e8e6b266ea29` — 6 info
  - api operation id `catalogAction` was added
  - added optional request body
  - the `query` request parameter `task` became optional
  - added the new enum value `update_catalog` to the `query` request parameter `task`
  - added the non-success response with the status `401`
  - removed the non-success response with the status `410`
- **2026-07-17** `9abb9bf6d3bf` — 3 breaking, 5 info
  - removed the enum value `garbage_collect` from the `query` request parameter `task`
  - removed the enum value `gather_art` from the `query` request parameter `task`
  - removed the enum value `verify_catalog` from the `query` request parameter `task`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `404`
  - removed the non-success response with the status `410`
  - removed the non-success response with the status `500`
- **2026-07-14** `aaf4166bdf3a` — 1 info
  - endpoint added
- **2026-07-06** `21e41c5adb1c` — 1 breaking
  - api path removed without deprecation
- **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/action/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/action/post)