Skip to content

Document collection delete rescans and media-item path drift for the next release - #174

Merged
enoch85 merged 2 commits into
mainfrom
copilot/update-documentation-for-next-release
Sep 16, 2026
Merged

enoch85 merged 2 commits into
mainfrom
copilot/update-documentation-for-next-release

Conversation

Copilot AI commented Sep 16, 2026 •

Copy link
Copy Markdown
Contributor

This drift report identified one user-visible collections behavior change and one public media-server contract change that were not yet reflected in the Next docs. This PR documents the post-delete rescan flow and the new optional path field surfaced by single-item media metadata reads.

  • Collections

    • Document that file-deleting Radarr, Sonarr, and Sportarr actions now ask the media server to rescan the affected folder after the delete.
    • Clarify that this rescan uses the media server's own path namespace, so it does not depend on the leftover-folder-cleanup bind mount or path mapping.
  • Media Server API

    • Document the optional path field on GET /api/media-server/meta/{id}.
    • Clarify the field's semantics:
      • movies and episodes return the media file path
      • shows and seasons return the folder path
      • Plex seasons do not provide a path
    • Note that paged/search/recent/children routes do not guarantee path.
  • Bundled OpenAPI snapshot

    • Update static/openapi-spec/maintainerr_api_specs.yaml to reflect the path field on the single-item metadata route.
  • Already covered by prior PRs

    • The pending collection membership reconciliation drift from the issue was already documented on main, so it is intentionally not duplicated here.
{
  "id": "12345",
  "title": "An example title",
  "type": "movie",
  "path": "/media/movies/An example title (2026)/An example title (2026).mkv",
  "library": { "id": "1", "title": "Movies" }
}

Co-authored-by: enoch85 <4511254+enoch85@users.noreply.github.com>
Copilot AI changed the title [WIP] Update documentation for next Maintainerr release Document collection delete rescans and media-item path drift for the next release Sep 16, 2026
Copilot AI requested a review from enoch85 September 16, 2026 12:16
@enoch85
enoch85 marked this pull request as ready for review September 16, 2026 13:05
@enoch85
enoch85 merged commit 1be2064 into main Sep 16, 2026
3 checks passed
@enoch85
enoch85 deleted the copilot/update-documentation-for-next-release branch September 16, 2026 13:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs drift - updates needed for the next Maintainerr release

2 participants