1. Ratings
Ludoria
  • Back to home
  • Residents
  • Lists
    • liked games lists
      • Retrieve a list
      • List all games from list
      • Like a game
      • Update a list
      • Remove game from list
    • played games lists
      • List all played games
      • Retrieve a played game
      • Add a played game
      • Update a played game
      • Remove a played game
    • List all lists
      GET
    • Retrieve a list
      GET
    • Create a list
      POST
    • Add game to list
      PUT
    • Update a list
      PATCH
    • Delete a list
      DELETE
    • Remove game from list
      DELETE
  • Reviews
    • List all reviews
      GET
    • Retrieve a review
      GET
    • Add a review
      POST
    • Update a review
      PATCH
    • Delete a review
      DELETE
  • Ratings
    • List all ratings
      GET
    • Retrieve a rating
      GET
    • Add a rating
      POST
    • Upsert a rating
      PUT
    • Update a rating
      PATCH
    • Delete a rating
      DELETE
  • Game Stats
    • List a resident's stats per game
      GET
  • Library
    • Get library visibility settings
      GET
    • List game library statuses as virtual lists
      GET
    • Update library visibility settings
      PATCH
    • List library entries for a resident
      GET
    • Add or upsert a library entry
      PUT
    • Get a library entry
      GET
    • Update a library entry
      PATCH
    • Remove a library entry
      DELETE
  • Liked Games
    • Get liked games for a resident
    • Like a game
    • Update liked-games visibility
    • Unlike a game
  • Deleted
    • obfuscates data
  • List all residents
    GET
  • Retrieve resident profile
    GET
  • Create a resident
    POST
  • Update a resident
    PATCH
  • Deletion request
    DELETE
  • Delete a resident
    DELETE
  • Follow a resident
    POST
  • Unfollow a resident
    DELETE
  1. Ratings

Upsert a rating

PUT
/v1/residents/{id}/ratings
ratingsresidents
Last modified:2026-05-25 04:07:29
Maintainer:JoseMa Esparza

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Header Params

Body Params application/json

Example
{
    "review_text": "Me encantó el bendito juego. Una obra maestra :)",
    "game_id": "129"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'http://localhost:4002/rest/v1/residents//ratings' \
--header 'X-Nexus-Key: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "review_text": "Me encantó el bendito juego. Una obra maestra :)",
    "game_id": "129"
}'

Responses

🟢201Created
application/json
Bodyapplication/json

Example
{
    "id": "rat_z1CMOl6mg6CJU9tp",
    "rating": 4,
    "game_id": "129",
    "resident_id": "res_z2mBqk28BgdRCi4W",
    "created_at": "2025-04-26T03:59:01.997Z",
    "updated_at": "2025-04-26T03:59:01.997Z"
}
🟠400Bad Request
🟠401Unathorized
🟠404Not Found
🔴500Server Error
Modified at 2026-05-25 04:07:29
Previous
Add a rating
Next
Update a rating
Built with