Version 10 aligns the library with Spotify's OpenAPI specification. Method names, request class names and packages now follow the specification's operation IDs and tags.

📣 Read the MIGRATION guide

   🚨 Breaking Changes

• Spotify Web API breaking changes for 2026-02-11  -  by @Copilot and dargmuesli in #448 (761d8)
• api: Sync specification  -  by @dargmuesli in #460 (e3c02)
• build: Ship an explicit JPMS module and vendor the country code enum  -  by @dargmuesli in #474 (384e9)
• models: Deserialize model objects reflectively with gson  -  by @dargmuesli in #473 (de189)

   🚀 Features

• user: Add create playlist endpoint  -  by @dargmuesli (a93ad)

   🐞 Bug Fixes

• build: Keep the automatic module name in the released jar  -  by @dargmuesli (b22d3)
• javadoc: Qualify cross-package links and document missing members  -  by @dargmuesli (bcca4)
• playlist: Allow to extend the has-total interface  -  by @dargmuesli (57276)

    View changes on GitHub

   🚨 Breaking Changes

• build: Ship an explicit JPMS module and vendor the country code enum  -  by @dargmuesli in #474 (384e9)

    View changes on GitHub

   🐞 Bug Fixes

• build: Keep the automatic module name in the released jar  -  by @dargmuesli (b22d3)

    View changes on GitHub

   🚨 Breaking Changes

• models: Deserialize model objects reflectively with gson  -  by @dargmuesli in #473 (de189)

    View changes on GitHub

   🚨 Breaking Changes

• api: Sync specification  -  by @dargmuesli in #460 (e3c02)

   🐞 Bug Fixes

• javadoc: Qualify cross-package links and document missing members  -  by @dargmuesli (bcca4)

    View changes on GitHub

   🐞 Bug Fixes

• playlist: Allow to extend the has-total interface  -  by @dargmuesli (57276)

    View changes on GitHub

   🚀 Features

• user: Add create playlist endpoint  -  by @dargmuesli (a93ad)

    View changes on GitHub

   🚨 Breaking Changes

• Spotify Web API breaking changes for 2026-02-11  -  by @Copilot and dargmuesli in #448 (761d8)

    View changes on GitHub

   🚀 Features

• Add smart_shuffle parameter to CurrentlyPlayingContext  -  by Momme Raap in #430 (40a0b)

    View changes on GitHub

   🚀 Features

• Add include_groups parameter to GetArtistsAlbumsRequest  -  by @julius-d in #419 (7af22)

   🐞 Bug Fixes

• Throw Exception on all 4xx and 5xx status codes  -  by @julius-d in #418 (7f0aa)
• Fix numeric strings being parsed as integers in JSON request bodies  -  by @copilot in #421 (7f0aa)

    [View changes on GitHub