info:
  name: Update Media Rating
  type: http
  seq: 1
http:
  method: PUT
  url: '{{base_url}}/api/media-items/{{media_item_id}}/rating'
  auth: inherit
  body:
    type: json
    jsonBody: "{\n    \"rating\": 4,\n    \"review\": \"Great book! Very enjoyable\
      \ read.\""
  headers:
  - key: Content-Type
    value: application/json
runtime:
  scripts:
  - type: tests
    code: "test_update_media_rating_success(status, headers, body) {\n    if (status\
      \ !== 200) {\n      throw new Error(\"Expected status 200, got \" + status);"

docs: |-
  ## Update Media Rating
  
    Updates an existing rating for a media item.
  
    **Method:** PUT
  
    **Endpoint:** /api/media-items/:id/rating
  
    **Authentication:** Required (Bearer token)
  
    **Path Parameters:**
    - `id` (string, required): Media item UUID
  
    **Request Body:**
    - `rating` (number, required): Rating value (typically 1-5)
    - `review` (string, optional): Review text
  
    **Response:** Updated rating object
    - `id` (string): Rating ID
    - `media_item_id` (string): Media item UUID
    - `rating` (number): Rating value
    - `review` (string): Review text
    - `created_at` (string): Creation timestamp
    - `updated_at` (string): Last update timestamp
  
    **Status Codes:**
    - 200: Success
    - 400: Invalid request body
    - 401: Unauthorized
    - 404: Media item or rating not found
    - 500: Internal server error
