> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stardrift.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Saved Item



## OpenAPI

````yaml /openapi.json patch /saved/{item_id}
openapi: 3.1.0
info:
  title: Stardrift API
  description: >-
    Read and edit the authenticated user's trips, itineraries, recorded
    bookings, and saved lists. Private records are owner-scoped. MCP tool names
    are documented separately from these HTTP operations.
  version: v1
servers:
  - url: https://stardrift.ai/api
security: []
paths:
  /saved/{item_id}:
    patch:
      tags:
        - saved
      summary: Update Saved Item
      operationId: update_saved_item_saved__item_id__patch
      parameters:
        - name: item_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Item Id
        - name: x-client-id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Client-Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateItemRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SavedItemOut'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    UpdateItemRequest:
      properties:
        caption:
          anyOf:
            - type: string
            - type: 'null'
          title: Caption
        list_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: List Id
        section_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Section Id
      type: object
      title: UpdateItemRequest
    SavedItemOut:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        list_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: List Id
        place_ref:
          type: string
          title: Place Ref
        place_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Place Id
        caption:
          anyOf:
            - type: string
            - type: 'null'
          title: Caption
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        name:
          type: string
          title: Name
        category:
          anyOf:
            - type: string
            - type: 'null'
          title: Category
        city:
          anyOf:
            - type: string
            - type: 'null'
          title: City
        state:
          anyOf:
            - type: string
            - type: 'null'
          title: State
        country:
          anyOf:
            - type: string
            - type: 'null'
          title: Country
        lat:
          anyOf:
            - type: number
            - type: 'null'
          title: Lat
        lng:
          anyOf:
            - type: number
            - type: 'null'
          title: Lng
        image_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Image Url
        image_thumbhash:
          anyOf:
            - type: string
            - type: 'null'
          title: Image Thumbhash
        rating:
          anyOf:
            - type: number
            - type: 'null'
          title: Rating
        num_reviews:
          anyOf:
            - type: integer
            - type: 'null'
          title: Num Reviews
        tabelog_tier:
          anyOf:
            - type: integer
            - type: 'null'
          title: Tabelog Tier
        michelin:
          anyOf:
            - $ref: '#/components/schemas/MichelinDistinction'
            - type: 'null'
        source:
          type: string
          title: Source
        source_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Url
        is_shared:
          type: boolean
          title: Is Shared
        review_state:
          anyOf:
            - type: string
            - type: 'null'
          title: Review State
        created_at:
          type: string
          title: Created At
      type: object
      required:
        - id
        - list_id
        - place_ref
        - place_id
        - caption
        - name
        - category
        - city
        - state
        - country
        - lat
        - lng
        - image_url
        - rating
        - num_reviews
        - source
        - source_url
        - is_shared
        - review_state
        - created_at
      title: SavedItemOut
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    MichelinDistinction:
      properties:
        tier:
          type: string
          enum:
            - stars
            - bib_gourmand
            - selected
          title: Tier
        stars:
          anyOf:
            - type: integer
            - type: 'null'
          title: Stars
        green_star:
          type: boolean
          title: Green Star
          default: false
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: Url
        cuisine:
          anyOf:
            - type: string
            - type: 'null'
          title: Cuisine
      type: object
      required:
        - tier
      title: MichelinDistinction
      description: >-
        A place's Michelin Guide distinction, structured. Canonical rationale —

        the TS mirror and the renderers point here rather than restating it.


        Rides alongside `michelin_award` rather than replacing it: that field is
        a

        pre-rendered label ("★★★"), and a label cannot drive iconography. An
        award

        string we don't recognise yields NO distinction (we never paint a mark
        we

        can't justify) while still surfacing verbatim in `michelin_award`, so a

        new tier degrades to text rather than disappearing.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````