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

# Update Quote Preferences



## OpenAPI

````yaml /user-docs/api-reference/quotes.swagger.json put /shipper/quote-preferences
openapi: 3.0.1
info:
  title: protobuf/shipping/v1/quotes.proto
  version: version not set
servers:
  - description: Production (US)
    url: https://api-lg-k.arms.cedarai.com
  - description: Production (EU)
    url: https://api-lg-k.arms.cedarai.se
security:
  - ApiKeyAuth: []
    AssumeUserAuth: []
tags:
  - name: QuotesService
paths:
  /shipper/quote-preferences:
    put:
      tags:
        - QuotesService
      summary: Update Quote Preferences
      operationId: UpdateQuotePreferences
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1QuotePreferences'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1QuotePreferences'
          description: A successful response.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
          description: An unexpected error response.
components:
  schemas:
    v1QuotePreferences:
      properties:
        destination_saved_facilities:
          description: |-
            Saved facilities favorited as quote destinations; counterpart of
            origin_saved_facilities.
          items:
            $ref: '#/components/schemas/v1SavedFacility'
          type: array
        favorite_commodity_sets:
          items:
            $ref: '#/components/schemas/v1CommoditySet'
          type: array
        favorite_destination_cif_sets:
          description: |-
            CIF customer sets favorited as quote destinations; counterpart of
            favorite_origin_cif_sets.
          items:
            $ref: '#/components/schemas/v1GeographySet'
          type: array
        favorite_destination_geography_sets:
          description: Geography sets favorited specifically as quote destinations.
          items:
            $ref: '#/components/schemas/v1GeographySet'
          type: array
        favorite_equipment_profile_sets:
          items:
            $ref: '#/components/schemas/v1EquipmentProfileSet'
          type: array
        favorite_geography_sets:
          description: >-
            Legacy direction-agnostic geography sets. Retained for backward
            compatibility:

            these remain usable for BOTH origin and destination search until
            quote

            preferences are re-saved, after which favorites are stored
            separately as

            origin and destination sets and this list is emptied. New clients
            should read

            these in addition to the origin/destination lists, and write only
            the

            origin/destination lists.
          items:
            $ref: '#/components/schemas/v1GeographySet'
          type: array
        favorite_origin_cif_sets:
          description: >-
            CIF customer sets favorited as quote origins. Values are 9-digit
            CIFs,

            optionally followed by a 4-digit sub-location suffix (13 digits
            total).
          items:
            $ref: '#/components/schemas/v1GeographySet'
          type: array
        favorite_origin_geography_sets:
          description: Geography sets favorited specifically as quote origins.
          items:
            $ref: '#/components/schemas/v1GeographySet'
          type: array
        origin_saved_facilities:
          description: >-
            Saved facilities favorited as quote origins; narrow the commodity
            and

            equipment choices when the selected origin is one of them.
          items:
            $ref: '#/components/schemas/v1SavedFacility'
          type: array
        quotes_hide_duplicate_junctions:
          description: >-
            When true, quote route search (ListQuotes) and the quote route
            typeahead

            (ListRoutes) hide routes that reuse an interchange junction — the
            same gateway

            appearing on more than one leg (for example UP-NEWOR-CSXT-NEWOR-NS,
            which doubles

            back through NEWOR). Defaults to true.


            On UpdateQuotePreferences the stored value is written only when this
            field is

            present, so a client that omits it (for example a favorites-only
            save) never

            changes it.
          type: boolean
      type: object
    rpcStatus:
      properties:
        code:
          format: int32
          type: integer
        details:
          items:
            $ref: '#/components/schemas/protobufAny'
          type: array
        message:
          type: string
      type: object
    v1SavedFacility:
      description: >-
        A saved facility (identified by CIF, e.g. one of your mills): the
        commodities

        and saved equipment profiles that facility ships/receives. When the
        facility

        is selected as a quote origin/destination, the form narrows the
        commodity and

        equipment choices to what it handles. A facility with no declarations
        imposes

        no restriction.
      properties:
        cif:
          description: >-
            9-digit CIF, optionally followed by a 4-digit sub-location suffix
            (13 digits

            total), same convention as favorite_origin_cif_sets values.
          type: string
        city_state:
          $ref: '#/components/schemas/v1CityState'
        equipment_profile_names:
          description: >-
            Names the saved equipment profiles this facility uses, e.g.

            "60HCBC" (matching EquipmentProfile.name in
            favorite_equipment_profile_sets).
          items:
            type: string
          type: array
        name:
          description: >-
            Optional label you choose for the facility, e.g. "Walla Walla, WA".

            Display-only; does not affect how the facility is matched on the
            quote form.
          type: string
        stccs:
          description: Commodities this facility ships/receives (STCC codes or prefixes).
          items:
            type: string
          type: array
      type: object
    v1CommoditySet:
      properties:
        name:
          type: string
        values:
          items:
            type: string
          title: stcc
          type: array
      type: object
    v1GeographySet:
      properties:
        name:
          type: string
        values:
          items:
            type: string
          title: city, st
          type: array
      type: object
    v1EquipmentProfileSet:
      properties:
        name:
          description: >-
            Label for the group, e.g. "Boxcars". Also an identifier: naming the
            set in

            ListQuotesRequest.equipment_profile_names selects every profile in
            it.
          type: string
        profiles:
          items:
            $ref: '#/components/schemas/v1EquipmentProfile'
          type: array
      type: object
    protobufAny:
      additionalProperties:
        type: object
      properties:
        '@type':
          type: string
      type: object
    v1CityState:
      properties:
        city:
          description: City name for the location.
          type: string
        state_or_province:
          description: State or province code (for example, TX, ON).
          type: string
      type: object
    v1EquipmentProfile:
      properties:
        car_type:
          $ref: '#/components/schemas/v1CarType'
        excluded_car_types:
          description: >-
            Car types carved out of the profile's car type, e.g. BOX_CAR
            excluding CUSHIONED_BOX_CAR and

            INSULATED_BOX_CAR. The profile then stands for the AAR car types its
            car type covers less those

            any excluded type covers: a rate restricted to only excluded car
            types is not returned, and a

            rate that excludes them (a negated GECT/ARCT) is. Requires a
            specific car_type or

            special_car_type: ListQuotes rejects exclusions on ALL_CAR_TYPES.
          items:
            $ref: '#/components/schemas/v1CarType'
          type: array
        excluded_marks:
          items:
            type: string
          type: array
        included_marks:
          description: >-
            Reporting marks (car initials, e.g. "BCOX", "IBT") describing which
            cars this profile

            stands for, evaluated against EQID (equipment identification)
            conditions.

              - included_marks, when non-empty, is the complete set of marks the profile's equipment
                carries. A rate that applies only to some other mark is not returned.
              - excluded_marks names marks the profile never carries -- the common case being "we own
                no cars with this initial". A rate restricted to an excluded mark is not returned.
          items:
            type: string
          type: array
        measurements:
          description: |-
            Dimension filters applied to the profile. At most one entry per
            MeasurementDimension.
          items:
            $ref: '#/components/schemas/v1MeasurementFilter'
          type: array
        name:
          description: >-
            Optional friendly label such as "60BC" -- your own abbreviation, not
            a standard code.


            For a profile saved in quote preferences this label is also its
            identifier: it is what

            ListQuotesRequest.equipment_profile_names and
            SavedFacility.equipment_profile_names refer

            to, and what Rate.matching_equipment_profile_names reports back.
            Names are matched

            case-insensitively after trimming surrounding whitespace.
          type: string
        ownership:
          $ref: '#/components/schemas/v1EquipmentOwnershipStatus'
        plate_codes:
          description: >-
            Acceptable Umler clearance plate codes (e.g. "B", "C", "F"),
            evaluated against

            EQCP (equipment clearance plate) conditions. When non-empty, quote
            search matches

            rates whose EQCP condition names any of these plate codes.
          items:
            type: string
          type: array
        special_car_type:
          $ref: '#/components/schemas/v1QuoteSpecialCarType'
      type: object
    v1CarType:
      enum:
        - ALL_CAR_TYPES
        - BI_LEVEL
        - BOX_CAR
        - BULKHEAD
        - CLOSED
        - CLOSED_BI_LEVEL
        - CLOSED_TRI_LEVEL
        - COIL
        - COVERED_COIL
        - COVERED_GONDOLA
        - CUSHIONED_BOX_CAR
        - FLAT_PEDESTAL
        - GONDOLA
        - GRAVITY_FLOW
        - INSULATED_BOX_CAR
        - MECHANICAL_REFRIGERATOR
        - OPEN
        - OPEN_COIL_CARS
        - OPEN_GONDOLA
        - OPEN_HOPPER
        - PLUG_DOORS
        - TRI_LEVEL
        - TRIPLE_CROSS_HOPPER
      type: string
    v1MeasurementFilter:
      description: |-
        A single dimension constraint on an EquipmentProfile.
        A profile may carry at most one filter per dimension.
      properties:
        dimension:
          $ref: '#/components/schemas/v1MeasurementDimension'
        range:
          $ref: '#/components/schemas/v1Range'
      type: object
    v1EquipmentOwnershipStatus:
      description: |-
        Equipment ownership status categories used in EQOS shipment conditions.

         - HIGHWAY_CARRIER: H - Highway carrier
         - SHIPPER_OWNED_OR_LEASED: S - Shipper owned or leased
         - STEAMSHIP_LINES: O - Steamship lines
         - RAILROAD_OWNED_OR_LEASED: R - Railroad owned or leased
      enum:
        - HIGHWAY_CARRIER
        - SHIPPER_OWNED_OR_LEASED
        - STEAMSHIP_LINES
        - RAILROAD_OWNED_OR_LEASED
      type: string
    v1QuoteSpecialCarType:
      enum:
        - FLAT
        - CENTER_BEAM
      type: string
    v1MeasurementDimension:
      description: >-
        Equipment measurement dimensions used to filter quote searches.

        Units are baked into each value so a single Range can describe any
        dimension.

         - CUBIC_FEET_CAPACITY: Cubic-feet capacity, evaluated against EQCM "PF" conditions.
         - GALLONS_CAPACITY: Gallon capacity, evaluated against EQCM "PG" conditions.
         - LOAD_LIMIT_POUNDS: Load limit in pounds, evaluated against EQCM "LB" conditions.
         - NET_WEIGHT_POUNDS: Actual net weight of the lading in pounds (the weight of the contents). Used two ways: rates
        whose weight break excludes this weight are not returned, and this is
        the weight the shipment

        is rated at, so weight-break tiers are priced against it.


        It is deliberately not matched against the equipment's own weight
        capacity (load limit plus

        tare), which is a property of the car rather than of the lading.
      enum:
        - OUTSIDE_LENGTH_INCHES
        - INSIDE_LENGTH_INCHES
        - INSIDE_HEIGHT_INCHES
        - CUBIC_FEET_CAPACITY
        - GALLONS_CAPACITY
        - LOAD_LIMIT_POUNDS
        - NET_WEIGHT_POUNDS
      type: string
    v1Range:
      description: Inclusive integer range. Units are determined by the consuming field.
      properties:
        from:
          format: int32
          type: integer
        to:
          format: int32
          type: integer
      type: object
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: x-arms-api-key
      type: apiKey
    AssumeUserAuth:
      in: header
      name: x-arms-assume-user
      type: apiKey

````

## Related topics

- [Get Quote Preferences](https://docs.cedarai.com/api-reference/quotesservice/get-quote-preferences.md)
- [List Shipper Quotes](https://docs.cedarai.com/api-reference/quotesservice/list-shipper-quotes.md)
- [Update a note](https://docs.cedarai.com/api-reference/lindaservice/update-a-note.md)
- [Update customer](https://docs.cedarai.com/api-reference/update-customer.md)
- [API Introduction](https://docs.cedarai.com/user-docs/api-reference/introduction.md)
