setRating

Sets the rating for a music file.

Parameters

Parameter	Req.	OpenS.	Default	Comment
`id`	Yes			A string which uniquely identifies the file (song) or folder (album/artist) to rate.
`rating`	Yes			The rating between 1 and 5 (inclusive), or 0 to remove the rating.

Example

http://your-server/rest/setRating.view?id=123&u=demo&p=demo&v=1.13.0&c=AwesomeClientName&f=json

Result

An empty subsonic-response element on success.

{
  "subsonic-response": {
    "status": "ok",
    "version": "1.16.1",
    "type": "AwesomeServerName",
    "serverVersion": "0.1.3 (tag)",
    "openSubsonic": true
  }
}

{
  "subsonic-response": {
    "status": "ok",
    "version": "1.16.1"
  }
}

Last modified June 12, 2025: linting, links to responses and endpoints reference their title (#154) (569b283)