---
title: Add a Personal Library Album Rating
framework: Apple Music API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple music 1.0+]
path: applemusicapi/add-a-personal-content-rating-98xt0
---

# 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

id: The unique identifier for the library album.

## Query Parameters

l: The localization to use, specified by a language tag. The possible values are in the supportedLanguageTags array belonging to the Storefront object specified by storefront. Otherwise, the default is defaultLanguageTag in Storefront.

## Response Codes

200 OK: The request was successful. 401 Unauthorized: A response indicating an incorrect Authorization header. 403 Forbidden: A response indicating invalid or insufficient authentication. 500 Internal Server Error: A response indicating an error occurred on the server.

## Discussion

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.

## See Also

### Related Documentation

- [Ratings](applemusicapi/ratings.md)
- [RatingsResponse](applemusicapi/ratingsresponse.md)

### Adding Library Ratings

- [Add a Personal Library Music Video Rating](applemusicapi/add-a-personal-content-rating-58x8v.md)
- [Add a Personal Library Playlist Rating](applemusicapi/add-a-personal-content-rating-91fzd.md)
- [Add a Personal Library Song Rating](applemusicapi/add-a-personal-content-rating-8z1fn.md)