---
title: Add a Personal 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-4zesn
---

# Add a Personal Album Rating

Add a user’s album rating by using the album’s identifier.

## URL

PUT https://api.music.apple.com/v1/me/ratings/albums/{id}

## Path Parameters

id: The unique identifier for the 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. 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 Catalog Ratings

- [Add a Personal Music Video Rating](applemusicapi/add-a-personal-content-rating-8hke5.md)
- [Add a Personal Playlist Rating](applemusicapi/add-a-personal-content-rating-76n4r.md)
- [Add a Personal Song Rating](applemusicapi/add-a-personal-content-rating-33dop.md)
- [Add a Personal Station Rating](applemusicapi/add-a-personal-content-rating-8zlgo.md)
