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

# Add a Personal Playlist Rating

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

## URL

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

## Path Parameters

id: The unique identifier for the playlist.

## 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 playlist. These are the only two ratings supported. For a particular playlist, the personal ratings for that playlist’s catalog ID and library ID (if the playlist 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 Catalog Ratings

- [Add a Personal Album Rating](applemusicapi/add-a-personal-content-rating-4zesn.md)
- [Add a Personal Music Video Rating](applemusicapi/add-a-personal-content-rating-8hke5.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)
