Spotify Web API

Save Albums for Current User

Developing

PUT

/me/albums

category-library

Save one or more albums to the current user's 'Your Music' library.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.spotify.com/v1/me/albums?ids=' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw ''

Response Example

200 - Example 1

{
  "error": {
    "message": "string",
    "status": 0
  }
}

Request

Query Params

ids

string

required

A comma-separated list of the Spotify IDs. For example: ids=4iV5W9uYEdYUVa79Axb7Rh,1301WleyT98MSxVHPZCA6M. Maximum: 50 IDs.

Header Params

Authorization

string

required

A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details.
Modification of the current user's "Your Music" collection requires authorization of the user-library-modify scope.

Content-Type

string

optional

Required if the IDs are passed in the request body, otherwise ignored. The content type of the request body: application/json

Body Params application/json

ids

array[string]

optional

A JSON array of the Spotify IDs. For example: ["4iV5W9uYEdYUVa79Axb7Rh", "1301WleyT98MSxVHPZCA6M"]
A maximum of 50 items can be specified in one request. Note: if the ids parameter is present in the query string, any IDs listed here in the body will be ignored.

Examples

Responses

🟢200OK

application/json

Body

error

object (ErrorObject)

optional

message

string

optional

A short description of the cause of the error.

status

integer <int32>

optional

The HTTP status code (also returned in the response header; see Response Status Codes for more information).

🟢201On success, the HTTP status code in the response header is `201` Created. On error, the header status code is an [error code](https://developer.spotify.com/documentation/web-api/#response-status-codes) and the response body contains an [error object](http

Modified at 2022-09-12 10:04:50

Get User's Saved Albums

Check User's Saved Albums