Skip to content

SABnzbd 5.0 API: history cleanup notes

Fetched: 2026-07-02 Source: https://sabnzbd.org/wiki/configuration/5.0/api

Scope: local digest for the Immich adult pipeline SAB history cleanup.

Required API shape

  • API endpoint: http://host:port/api
  • Most calls require apikey=APIKEY and may use output=json.
  • History listing: mode=history&start=START&limit=LIMIT&cat=CATEGORY&search=SEARCH&nzo_ids=NZO_ID_1,NZO_ID_2&failed_only=0
  • History listing accepts category or cat to filter by category.
  • History listing accepts status; documented values include Completed and Failed.
  • History entries include nzo_id, status, storage, path, and archive.
  • Delete or archive a history item: mode=history&name=delete&value=NZO_ID
  • Full removal instead of archive: mode=history&name=delete&archive=0&value=NZO_ID
  • Multiple item removal: mode=history&name=delete&archive=0&value=NZO_ID_1,NZO_ID_2,NZO_ID_3

Local safety decision

For the Immich adult pipeline, delete only SAB history rows where:

  • cat=immich-adult
  • status=Completed
  • the SAB storage path maps to the sorter's mounted NFS path
  • that mapped path is missing or contains no files

Do not pass del_files=1; the sorter already removes source files after successful materialization, and nonempty storage directories must remain visible in SAB until the pipeline drains them.