René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"feat(spotify)!: technical specification for changes to the api starting 2026-02-11","articleBody":"# Technical changes for https://github.com/spotify-web-api-java/spotify-web-api-java/issues/445\n\nMinimal instructions for agentic work to resolve the issue.\n\n## 🔄 Endpoint Changes\n\n### ❌ Removed Endpoints\n\n- **Create Playlist for User**  \n  `POST /users/{user_id}/playlists`  \n  _Create a playlist for a Spotify user._  \n  ➡️ Use `POST /me/playlists` instead\n\n- **Get Artist's Top Tracks**  \n  `GET /artists/{id}/top-tracks`  \n  _Get Spotify catalog information about an artist's top tracks by country._\n\n- **Get Available Markets**  \n  `GET /markets`  \n  _Get the list of markets where Spotify is available._\n\n- **Get New Releases**  \n  `GET /browse/new-releases`  \n  _Get a list of new album releases featured in Spotify._\n\n- **Get Several Albums**  \n  `GET /albums`\n\n- **Get Several Artists**  \n  `GET /artists`\n\n- **Get Several Audiobooks**  \n  `GET /audiobooks`\n\n- **Get Several Browse Categories**  \n  `GET /browse/categories`\n\n- **Get Several Chapters**  \n  `GET /chapters`\n\n- **Get Several Episodes**  \n  `GET /episodes`\n\n- **Get Several Shows**  \n  `GET /shows`\n\n- **Get Several Tracks**  \n  `GET /tracks`\n\n- **Get Single Browse Category**  \n  `GET /browse/categories/{id}`\n\n- **Get User's Playlists**  \n  `GET /users/{id}/playlists`\n\n- **Get User's Profile**  \n  `GET /users/{id}`\n\n---\n\n### ➕ Added Endpoints\n\n- **Save to Library**  \n  `PUT /me/library`  \n  _Save a list of Spotify URIs to the user's library._\n\n- **Remove from Library**  \n  `DELETE /me/library`  \n  _Remove a list of Spotify URIs from the user's library._\n\n---\n\n### ❌ Removed (Replaced by `/me/library`)\n\n- **Remove Albums for Current User**  \n  `DELETE /me/albums`  \n  ➡️ Use `DELETE /me/library`\n\n- **Remove Audiobooks for Current User**  \n  `DELETE /me/audiobooks`  \n  ➡️ Use `DELETE /me/library`\n\n- **Remove Episodes for Current User**  \n  `DELETE /me/episodes`  \n  ➡️ Use `DELETE /me/library`\n\n- **Remove Shows for Current User**  \n  `DELETE /me/shows`  \n  ➡️ Use `DELETE /me/library`\n\n- **Remove Tracks for Current User**  \n  `DELETE /me/tracks`  \n  ➡️ Use `DELETE /me/library`\n\n- **Save Albums for Current User**  \n  `PUT /me/albums`  \n  ➡️ Use `PUT /me/library`\n\n- **Save Audiobooks for Current User**  \n  `PUT /me/audiobooks`  \n  ➡️ Use `PUT /me/library`\n\n- **Save Episodes for Current User**  \n  `PUT /me/episodes`  \n  ➡️ Use `PUT /me/library`\n\n- **Save Shows for Current User**  \n  `PUT /me/shows`  \n  ➡️ Use `PUT /me/library`\n\n- **Save Tracks for Current User**  \n  `PUT /me/tracks`  \n  ➡️ Use `PUT /me/library`\n\n---\n\n## 🧩 Response Field Changes\n\nThese changes apply wherever the following objects appear in API responses.\n\n---\n\n### Album\n\nRemoved fields:\n- `album_group`\n- `available_markets`\n- `external_ids`\n- `label`\n- `popularity`\n\n---\n\n### Artist\n\nRemoved fields:\n- `followers`\n- `popularity`\n\n---\n\n### Audiobook\n\nRemoved fields:\n- `available_markets`\n- `publisher`\n\n---\n\n### Chapter\n\nRemoved fields:\n- `available_markets`\n\n---\n\n### Playlist\n\n\u003e Only **user-owned playlists** will return playlist contents.  \n\u003e Other playlists return **metadata only**.\n\nRenamed fields:\n- `tracks` → `items`\n- `tracks.tracks` → `items.items`\n- `tracks.tracks.track` → `items.items.item`\n\n---\n\n### Show\n\nRemoved fields:\n- `available_markets`\n- `publisher`\n\n---\n\n### Track\n\nRemoved fields:\n- `available_markets`\n- `external_ids`\n- `linked_from`\n- `popularity`\n\n---\n\n### User\n\nRemoved fields:\n- `country`\n- `email`\n- `explicit_content`\n- `followers`\n- `product`\n\n---\n\n## ✅ Expected Work\n\n- Remove deprecated endpoints and related request/response models\n- Add `/me/library` PUT and DELETE endpoints\n- Update DTOs / models to reflect removed fields\n- Rename playlist-related fields as specified\n- Adjust deserialization logic accordingly\n- Update tests and documentation where applicable\n\n---\n\n## 📌 Notes\n\nThese changes apply globally across all affected endpoints and models.","author":{"url":"https://github.com/dargmuesli","@type":"Person","name":"dargmuesli"},"datePublished":"2026-02-11T10:54:21.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/447/spotify-web-api-java/issues/447"}