<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "AppleMusicAPI",
  "identifier" : "/documentation/AppleMusicAPI/Add-a-Personal-Content-Rating-91fzd",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Music API"
    ],
    "preciseIdentifier" : "rest:music_api:put:v1-me-ratings-library-playlists-{}"
  },
  "title" : "Add a Personal Library Playlist Rating"
}
-->

# Add a Personal Library Playlist Rating

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

## Discussion

This endpoint requires a music user token. For more information, see [User Authentication for MusicKit](/documentation/AppleMusicAPI/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

**Request:**

```
https://api.music.apple.com/v1/me/ratings/library-playlists/p.MoGJYM3CYXW09B

{
    "type":"rating",
    "attributes":{
        "value":1
    }
}
```

**Response:**

```json
{
   "data":[
      {
         "id":"p.MoGJYM3CYXW09B",
         "type":"ratings",
         "href":"/v1/me/ratings/library-playlists/p.MoGJYM3CYXW09B",
         "attributes":{
            "value":1
         }
      }
   ]
}
```

## See Also

[`object Ratings`](/documentation/AppleMusicAPI/Ratings)

An object that represents a rating for a resource.

[`object RatingsResponse`](/documentation/AppleMusicAPI/RatingsResponse)

The response to a request for a rating.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)