Add a Personal Library Album Rating
Add a user’s content rating by using the content’s identifier.
URL
PUT https://api.music.apple.com/v1/me/ratings/library-albums/{id}Path Parameters
| Name | Type | Description |
|---|---|---|
id Required | string | The unique identifier for the library album. |
Query Parameters
| Name | Type | Description |
|---|---|---|
l Optional | string | The localization to use, specified by a language tag. The possible values are in the |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | RatingsResponse | The request was successful. |
| 401 | Unauthorized Content-Type: application/json | UnauthorizedResponse | A response indicating an incorrect |
| 403 | Forbidden Content-Type: application/json | ForbiddenResponse | A response indicating invalid or insufficient authentication. |
| 500 | Internal Server Error Content-Type: application/json | ErrorsResponse | A response indicating an error occurred on the server. |
Discussion
This endpoint requires a music user token. For more information, see User Authentication for MusicKit.
A rating indicates whether a user likes (1) or dislikes (-1) the album. These are the only two ratings supported.
For a particular album, the personal ratings for that album’s catalog ID and library ID (if the album is in the library) stay synced.
Example
HTTP Body
A dictionary that includes the type and attributes of the resource rating.