Rename playlist /tracks endpoints to /items

[wardbox]

Summary

• Migrates all playlist item management endpoints from /playlists/{id}/tracks to /playlists/{id}/items per Spotify's Feb 2026 API changes
• Updates the Remove-PlaylistItems request body key from tracks to items
• Renames $Track parameter to $Item with [Alias('Track')] for backward compatibility
• Affects 5 files: Get-PlaylistItems, Add-PlaylistItem, Remove-PlaylistItems, Edit-PlaylistOrder, Set-PlaylistItems

Closes #72
Related to #70

Checklist

• CHANGELOG.md updated (will be updated as part of v2.0.0 release Release v2.0.0 - Spotify Feb 2026 API migration #78)
• Local tests verified via Invoke-Pester — 58/58 passing

Test plan

• Module imports successfully with Import-Module ./Spotishell/Spotishell.psd1 -Force
• All 5 affected cmdlets load and reference /items endpoint
• No remaining references to /tracks in playlist endpoint URLs
• Remove-PlaylistItems body uses items key instead of tracks
• -Track alias still works for backward compatibility

🤖 Generated with Claude Code

[coderabbitai]

Walkthrough

Five playlist-management scripts and a test were updated to use Spotify's renamed playlist endpoints: /v1/playlists/{id}/tracks → /v1/playlists/{id}/items. One script also updates the request-body key from tracks to items.

Changes

Cohort / File(s)	Summary
Endpoint Path Updates Spotishell/Public/Playlists/Add-PlaylistItem.ps1, Spotishell/Public/Playlists/Edit-PlaylistOrder.ps1, Spotishell/Public/Playlists/Get-PlaylistItems.ps1, Spotishell/Public/Playlists/Set-PlaylistItems.ps1	Replaced API path /v1/playlists/{Id}/tracks with /v1/playlists/{Id}/items. Request construction, payload shape, and iteration logic unchanged.
Endpoint + Payload Key Update Spotishell/Public/Playlists/Remove-PlaylistItems.ps1	Replaced API path /v1/playlists/{Id}/tracks with /v1/playlists/{Id}/items and renamed request-body key from tracks to items. Batching and snapshot_id handling preserved.
Tests Updated Tests/Spotishell.Tests.ps1	Updated mocked expectation(s) to assert requests target /v1/playlists/{playlistId}/items instead of /tracks.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• Fix Add-PlaylistItem URI handling and add Get-RecentlyPlayedTracks context #61: Modifies Add-PlaylistItem.ps1 (input/URI normalization and ItemType handling); touches the same function updated here.

Poem

🐰 I hopped through code to make things right,

/tracks now hops to /items in sight,
Five scripts aligned, one test did cheer,
A tiny change — the path is clear,
Carrots for CI, and a joyful ear 🥕

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'Rename playlist /tracks endpoints to /items' clearly and concisely summarizes the main change in the PR.
Linked Issues check	✅ Passed	All five affected files have been updated with endpoint changes from /tracks to /items, request body key updated, and tests modified accordingly.
Out of Scope Changes check	✅ Passed	All changes are directly related to the linked issue #72 objective of migrating endpoints from /tracks to /items across the five specified files.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description check	✅ Passed	The PR description comprehensively covers the changes, provides detailed checklists with verification status, and links to related issues.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

📝 Coding Plan

• Generate coding plan for human review comments

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

🧹 Nitpick comments (1)

Spotishell/Public/Playlists/Remove-PlaylistItems.ps1 (1)

30-32: Consider renaming the $Track parameter to $Item for consistency.

The parameter is still named $Track (line 32) and referenced as -Track in examples (lines 5, 8, 11), while the API now uses items terminology. For consistency with the new API and the body key change, consider renaming this parameter in a future update.

This is a breaking change for existing scripts, so if backward compatibility is a concern, you could add a parameter alias:

♻️ Suggested approach with backward compatibility

 [Parameter(Mandatory, ValueFromPipeline)]
+[Alias('Track')]
 [array]
-$Track,
+$Item,

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@Spotishell/Public/Playlists/Remove-PlaylistItems.ps1` around lines 30 - 32,
The parameter $Track in Remove-PlaylistItems.ps1 should be renamed to $Item to
match the API's "items" terminology and the body key change; update the
parameter declaration (currently "[array] $Track") and all internal references
to use $Item, and if you need backward compatibility add an Alias for the old
name (e.g., apply an Alias attribute referencing "Track") so callers using
-Track keep working while new code uses -Item.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@Spotishell/Public/Playlists/Remove-PlaylistItems.ps1`:
- Around line 30-32: The parameter $Track in Remove-PlaylistItems.ps1 should be
renamed to $Item to match the API's "items" terminology and the body key change;
update the parameter declaration (currently "[array] $Track") and all internal
references to use $Item, and if you need backward compatibility add an Alias for
the old name (e.g., apply an Alias attribute referencing "Track") so callers
using -Track keep working while new code uses -Item.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 05012734-2e27-4dda-8b38-5d34025d9e1b

📥 Commits

Reviewing files that changed from the base of the PR and between 7bfd599 and 4d53fd2.

📒 Files selected for processing (5)

• Spotishell/Public/Playlists/Add-PlaylistItem.ps1
• Spotishell/Public/Playlists/Edit-PlaylistOrder.ps1
• Spotishell/Public/Playlists/Get-PlaylistItems.ps1
• Spotishell/Public/Playlists/Remove-PlaylistItems.ps1
• Spotishell/Public/Playlists/Set-PlaylistItems.ps1