Adobe Commerce API

securityDefinitions:
  api_key:
    type: apiKey
    name: api_key
    in: header
swagger: "2.0"
info:
  version: 2.4.6
  title: Commerce Guest REST endpoints - All inclusive
  description: 
    $ref: intro/redocly-intro.md
host: example.com
basePath: /rest/default
schemes:
  - https
tags:
  - name: applepay/auth
  - name: carts/guest-carts/{cartId}/checkGiftCard/{giftCardCode}
  - name: carts/guest-carts/{cartId}/giftCards
  - name: carts/guest-carts/{cartId}/giftCards/{giftCardCode}
  - name: customers
  - name: customers/{customerId}/password/resetLinkToken/{resetPasswordLinkToken}
  - name: customers/isEmailAvailable
  - name: customers/password
  - name: customers/resetPassword
  - name: directory/countries
  - name: directory/countries/{countryId}
  - name: directory/currency
  - name: guest-carts
  - name: guest-carts/{cartId}
  - name: guest-carts/{cartId}/billing-address
  - name: guest-carts/{cartId}/collect-totals
  - name: guest-carts/{cartId}/coupons
  - name: guest-carts/{cartId}/coupons/{couponCode}
  - name: guest-carts/{cartId}/estimate-shipping-methods
  - name: guest-carts/{cartId}/gift-message
  - name: guest-carts/{cartId}/gift-message/{itemId}
  - name: guest-carts/{cartId}/items
  - name: guest-carts/{cartId}/items/{itemId}
  - name: guest-carts/{cartId}/order
  - name: guest-carts/{cartId}/payment-information
  - name: guest-carts/{cartId}/payment-methods
  - name: guest-carts/{cartId}/selected-payment-method
  - name: guest-carts/{cartId}/set-payment-information
  - name: guest-carts/{cartId}/shipping-information
  - name: guest-carts/{cartId}/shipping-methods
  - name: guest-carts/{cartId}/totals
  - name: guest-carts/{cartId}/totals-information
  - name: guest-giftregistry/{cartId}/estimate-shipping-methods
  - name: integration/admin/token
  - name: integration/customer/token
  - name: inventory/in-store-pickup/pickup-locations/
  - name: products-render-info
  - name: quick-checkout/account-details
  - name: quick-checkout/has-account
  - name: quick-checkout/storefront/has-account
  - name: search
  - name: tfa/provider/authy/activate
  - name: tfa/provider/authy/authenticate
  - name: tfa/provider/authy/authenticate-onetouch
  - name: tfa/provider/authy/configure
  - name: tfa/provider/authy/send-token/{via}
  - name: tfa/provider/duo_security/activate
  - name: tfa/provider/duo_security/authenticate
  - name: tfa/provider/duo_security/configure
  - name: tfa/provider/duo_security/get-authentication-data
  - name: tfa/provider/google/activate
  - name: tfa/provider/google/authenticate
  - name: tfa/provider/google/configure
  - name: tfa/provider/u2fkey/activate
  - name: tfa/provider/u2fkey/authentication-challenge
  - name: tfa/provider/u2fkey/configure
  - name: tfa/provider/u2fkey/verify
  - name: tfa/tfat-providers-to-activate
  - name: tfa/tfat-user-providers
paths:
  /V1/applepay/auth:
    get:
      tags:
        - applepay/auth
      description: Returns details required to be able to submit a payment with apple pay.
      operationId: GetV1ApplepayAuth
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      responses:
        "200":
          description: 200 Success.
          schema:
            $ref: "#/definitions/pay-pal-braintree-data-auth-data-interface"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: applepay/auth
  "/V1/carts/guest-carts/{cartId}/checkGiftCard/{giftCardCode}":
    get:
      tags:
        - carts/guest-carts/{cartId}/checkGiftCard/{giftCardCode}
      description: Check gift card balance if added to the cart.
      operationId: GetV1CartsGuestcartsCartIdCheckGiftCardGiftCardCode
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
        - name: giftCardCode
          in: path
          type: string
          required: true
      responses:
        "200":
          description: 200 Success.
          schema:
            type: number
        "400":
          description: 400 Bad Request
          schema:
            $ref: "#/definitions/error-response"
        "500":
          description: Internal Server error
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: carts/guest-carts/{cartId}/checkGiftCard/{giftCardCode}
  "/V1/carts/guest-carts/{cartId}/giftCards":
    post:
      tags:
        - carts/guest-carts/{cartId}/giftCards
      description: Add gift card to the cart.
      operationId: PostV1CartsGuestcartsCartIdGiftCards
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
        - name: PostV1CartsGuestcartsCartIdGiftCardsBody
          in: body
          schema:
            required:
              - giftCardAccountData
            properties:
              giftCardAccountData:
                $ref: "#/definitions/gift-card-account-data-gift-card-account-interface"
            type: object
            xml:
              name: request
      responses:
        "200":
          description: 200 Success.
          schema:
            type: boolean
        "500":
          description: Internal Server error
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: carts/guest-carts/{cartId}/giftCards
  "/V1/carts/guest-carts/{cartId}/giftCards/{giftCardCode}":
    delete:
      tags:
        - carts/guest-carts/{cartId}/giftCards/{giftCardCode}
      description: Remove GiftCard Account entity.
      operationId: DeleteV1CartsGuestcartsCartIdGiftCardsGiftCardCode
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
        - name: giftCardCode
          in: path
          type: string
          required: true
      responses:
        "200":
          description: 200 Success.
          schema:
            type: boolean
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: carts/guest-carts/{cartId}/giftCards/{giftCardCode}
  /V1/customers:
    post:
      tags:
        - customers
      description: Create customer account. Perform necessary business operations like
        sending email.
      operationId: PostV1Customers
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: PostV1CustomersBody
          in: body
          schema:
            required:
              - customer
            properties:
              customer:
                $ref: "#/definitions/customer-data-customer-interface"
              password:
                type: string
              redirectUrl:
                type: string
            type: object
            xml:
              name: request
      responses:
        "200":
          description: 200 Success.
          schema:
            $ref: "#/definitions/customer-data-customer-interface"
        "500":
          description: Internal Server error
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: customers
  /V1/customers/isEmailAvailable:
    post:
      tags:
        - customers/isEmailAvailable
      description: Check if given email is associated with a customer account in given
        website.
      operationId: PostV1CustomersIsEmailAvailable
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: PostV1CustomersIsEmailAvailableBody
          in: body
          schema:
            required:
              - customerEmail
            properties:
              customerEmail:
                type: string
              websiteId:
                type: integer
                description: If not set, will use the current websiteId
            type: object
            xml:
              name: request
      responses:
        "200":
          description: 200 Success.
          schema:
            type: boolean
        "500":
          description: Internal Server error
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: customers/isEmailAvailable
  /V1/customers/password:
    put:
      tags:
        - customers/password
      description: Send an email to the customer with a password reset link.
      operationId: PutV1CustomersPassword
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: PutV1CustomersPasswordBody
          in: body
          schema:
            required:
              - email
              - template
            properties:
              email:
                type: string
              template:
                type: string
              websiteId:
                type: integer
            type: object
            xml:
              name: request
      responses:
        "200":
          description: 200 Success.
          schema:
            type: boolean
            description: true on success
        "500":
          description: Internal Server error
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: customers/password
  /V1/customers/resetPassword:
    post:
      tags:
        - customers/resetPassword
      description: Reset customer password.
      operationId: PostV1CustomersResetPassword
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: PostV1CustomersResetPasswordBody
          in: body
          schema:
            required:
              - email
              - resetToken
              - newPassword
            properties:
              email:
                type: string
                description: If empty value given then the customer will be matched by the RP
                  token.
              resetToken:
                type: string
              newPassword:
                type: string
            type: object
            xml:
              name: request
      responses:
        "200":
          description: 200 Success.
          schema:
            type: boolean
            description: true on success
        "500":
          description: Internal Server error
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: customers/resetPassword
  "/V1/customers/{customerId}/password/resetLinkToken/{resetPasswordLinkToken}":
    get:
      tags:
        - customers/{customerId}/password/resetLinkToken/{resetPasswordLinkToken}
      description: Check if password reset token is valid.
      operationId: GetV1CustomersCustomerIdPasswordResetLinkTokenResetPasswordLinkToken
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: customerId
          in: path
          type: integer
          required: true
          description: If null is given then a customer will be matched by the RP token.
        - name: resetPasswordLinkToken
          in: path
          type: string
          required: true
      responses:
        "200":
          description: 200 Success.
          schema:
            type: boolean
            description: True if the token is valid
        "400":
          description: 400 Bad Request
          schema:
            $ref: "#/definitions/error-response"
        "500":
          description: Internal Server error
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: customers/{customerId}/password/resetLinkToken/{resetPasswordLinkToken}
  /V1/directory/countries:
    get:
      tags:
        - directory/countries
      description: Get all countries and regions information for the store.
      operationId: GetV1DirectoryCountries
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      responses:
        "200":
          description: 200 Success.
          schema:
            type: array
            items:
              $ref: "#/definitions/directory-data-country-information-interface"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: directory/countries
  "/V1/directory/countries/{countryId}":
    get:
      tags:
        - directory/countries/{countryId}
      description: Get country and region information for the store.
      operationId: GetV1DirectoryCountriesCountryId
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: countryId
          in: path
          type: string
          required: true
      responses:
        "200":
          description: 200 Success.
          schema:
            $ref: "#/definitions/directory-data-country-information-interface"
        "400":
          description: 400 Bad Request
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: directory/countries/{countryId}
  /V1/directory/currency:
    get:
      tags:
        - directory/currency
      description: Get currency information for the store.
      operationId: GetV1DirectoryCurrency
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      responses:
        "200":
          description: 200 Success.
          schema:
            $ref: "#/definitions/directory-data-currency-information-interface"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: directory/currency
  /V1/guest-carts:
    post:
      tags:
        - guest-carts
      description: Enable an customer or guest user to create an empty cart and quote
        for an anonymous customer.
      operationId: PostV1Guestcarts
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      responses:
        "200":
          description: 200 Success.
          schema:
            type: string
            description: Cart ID.
        "400":
          description: 400 Bad Request
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: guest-carts
  "/V1/guest-carts/{cartId}":
    get:
      tags:
        - guest-carts/{cartId}
      description: Enable a guest user to return information for a specified cart.
      operationId: GetV1GuestcartsCartId
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
      responses:
        "200":
          description: 200 Success.
          schema:
            $ref: "#/definitions/quote-data-cart-interface"
        "400":
          description: 400 Bad Request
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: guest-carts/{cartId}
  "/V1/guest-carts/{cartId}/billing-address":
    get:
      tags:
        - guest-carts/{cartId}/billing-address
      description: Return the billing address for a specified quote.
      operationId: GetV1GuestcartsCartIdBillingaddress
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
          description: The cart ID.
      responses:
        "200":
          description: 200 Success.
          schema:
            $ref: "#/definitions/quote-data-address-interface"
        "400":
          description: 400 Bad Request
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: guest-carts/{cartId}/billing-address
    post:
      tags:
        - guest-carts/{cartId}/billing-address
      description: Assign a specified billing address to a specified cart.
      operationId: PostV1GuestcartsCartIdBillingaddress
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
          description: The cart ID.
        - name: PostV1GuestcartsCartIdBillingaddressBody
          in: body
          schema:
            required:
              - address
            properties:
              address:
                $ref: "#/definitions/quote-data-address-interface"
              useForShipping:
                type: boolean
            type: object
            xml:
              name: request
      responses:
        "200":
          description: 200 Success.
          schema:
            type: integer
            description: Address ID.
        "400":
          description: 400 Bad Request
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: guest-carts/{cartId}/billing-address
  "/V1/guest-carts/{cartId}/collect-totals":
    put:
      tags:
        - guest-carts/{cartId}/collect-totals
      description: Set shipping/billing methods and additional data for cart and
        collect totals for guest.
      operationId: PutV1GuestcartsCartIdCollecttotals
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
          description: The cart ID.
        - name: PutV1GuestcartsCartIdCollecttotalsBody
          in: body
          schema:
            required:
              - paymentMethod
            properties:
              paymentMethod:
                $ref: "#/definitions/quote-data-payment-interface"
              shippingCarrierCode:
                type: string
                description: The carrier code.
              shippingMethodCode:
                type: string
                description: The shipping method code.
              additionalData:
                $ref: "#/definitions/quote-data-totals-additional-data-interface"
            type: object
            xml:
              name: request
      responses:
        "200":
          description: 200 Success.
          schema:
            $ref: "#/definitions/quote-data-totals-interface"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: guest-carts/{cartId}/collect-totals
  "/V1/guest-carts/{cartId}/coupons":
    get:
      tags:
        - guest-carts/{cartId}/coupons
      description: Return information for a coupon in a specified cart.
      operationId: GetV1GuestcartsCartIdCoupons
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
          description: The cart ID.
      responses:
        "200":
          description: 200 Success.
          schema:
            type: string
            description: The coupon code data.
        "400":
          description: 400 Bad Request
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: guest-carts/{cartId}/coupons
    delete:
      tags:
        - guest-carts/{cartId}/coupons
      description: Delete a coupon from a specified cart.
      operationId: DeleteV1GuestcartsCartIdCoupons
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
          description: The cart ID.
      responses:
        "200":
          description: 200 Success.
          schema:
            type: boolean
        "400":
          description: 400 Bad Request
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: guest-carts/{cartId}/coupons
  "/V1/guest-carts/{cartId}/coupons/{couponCode}":
    put:
      tags:
        - guest-carts/{cartId}/coupons/{couponCode}
      description: Add a coupon by code to a specified cart.
      operationId: PutV1GuestcartsCartIdCouponsCouponCode
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
          description: The cart ID.
        - name: couponCode
          in: path
          type: string
          required: true
          description: The coupon code data.
      responses:
        "200":
          description: 200 Success.
          schema:
            type: boolean
        "400":
          description: 400 Bad Request
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: guest-carts/{cartId}/coupons/{couponCode}
  "/V1/guest-carts/{cartId}/estimate-shipping-methods":
    post:
      tags:
        - guest-carts/{cartId}/estimate-shipping-methods
      description: Estimate shipping by address and return list of available shipping
        methods
      operationId: PostV1GuestcartsCartIdEstimateshippingmethods
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
        - name: PostV1GuestcartsCartIdEstimateshippingmethodsBody
          in: body
          schema:
            required:
              - address
            properties:
              address:
                $ref: "#/definitions/quote-data-address-interface"
            type: object
            xml:
              name: request
      responses:
        "200":
          description: 200 Success.
          schema:
            type: array
            description: An array of shipping methods
            items:
              $ref: "#/definitions/quote-data-shipping-method-interface"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: guest-carts/{cartId}/estimate-shipping-methods
  "/V1/guest-carts/{cartId}/gift-message":
    get:
      tags:
        - guest-carts/{cartId}/gift-message
      description: Return the gift message for a specified order.
      operationId: GetV1GuestcartsCartIdGiftmessage
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
          description: The shopping cart ID.
      responses:
        "200":
          description: 200 Success.
          schema:
            $ref: "#/definitions/gift-message-data-message-interface"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: guest-carts/{cartId}/gift-message
    post:
      tags:
        - guest-carts/{cartId}/gift-message
      description: Set the gift message for an entire order.
      operationId: PostV1GuestcartsCartIdGiftmessage
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
          description: The cart ID.
        - name: PostV1GuestcartsCartIdGiftmessageBody
          in: body
          schema:
            required:
              - giftMessage
            properties:
              giftMessage:
                $ref: "#/definitions/gift-message-data-message-interface"
            type: object
            xml:
              name: request
      responses:
        "200":
          description: 200 Success.
          schema:
            type: boolean
        "400":
          description: 400 Bad Request
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: guest-carts/{cartId}/gift-message
  "/V1/guest-carts/{cartId}/gift-message/{itemId}":
    get:
      tags:
        - guest-carts/{cartId}/gift-message/{itemId}
      description: Return the gift message for a specified item in a specified
        shopping cart.
      operationId: GetV1GuestcartsCartIdGiftmessageItemId
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
          description: The shopping cart ID.
        - name: itemId
          in: path
          type: integer
          required: true
          description: The item ID.
      responses:
        "200":
          description: 200 Success.
          schema:
            $ref: "#/definitions/gift-message-data-message-interface"
        "400":
          description: 400 Bad Request
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: guest-carts/{cartId}/gift-message/{itemId}
    post:
      tags:
        - guest-carts/{cartId}/gift-message/{itemId}
      description: Set the gift message for a specified item in a specified shopping cart.
      operationId: PostV1GuestcartsCartIdGiftmessageItemId
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
          description: The cart ID.
        - name: itemId
          in: path
          type: integer
          required: true
          description: The item ID.
        - name: PostV1GuestcartsCartIdGiftmessageItemIdBody
          in: body
          schema:
            required:
              - giftMessage
            properties:
              giftMessage:
                $ref: "#/definitions/gift-message-data-message-interface"
            type: object
            xml:
              name: request
      responses:
        "200":
          description: 200 Success.
          schema:
            type: boolean
        "400":
          description: 400 Bad Request
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: guest-carts/{cartId}/gift-message/{itemId}
  "/V1/guest-carts/{cartId}/items":
    get:
      tags:
        - guest-carts/{cartId}/items
      description: List items that are assigned to a specified cart.
      operationId: GetV1GuestcartsCartIdItems
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
          description: The cart ID.
      responses:
        "200":
          description: 200 Success.
          schema:
            type: array
            description: Array of items.
            items:
              $ref: "#/definitions/quote-data-cart-item-interface"
        "400":
          description: 400 Bad Request
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: guest-carts/{cartId}/items
    post:
      tags:
        - guest-carts/{cartId}/items
      description: Add/update the specified cart item.
      operationId: PostV1GuestcartsCartIdItems
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
        - name: PostV1GuestcartsCartIdItemsBody
          in: body
          schema:
            required:
              - cartItem
            properties:
              cartItem:
                $ref: "#/definitions/quote-data-cart-item-interface"
            type: object
            xml:
              name: request
      responses:
        "200":
          description: 200 Success.
          schema:
            $ref: "#/definitions/quote-data-cart-item-interface"
        "400":
          description: 400 Bad Request
          schema:
            $ref: "#/definitions/error-response"
        default:
          description: Unexpected error
          schema:
            $ref: "#/definitions/error-response"
      summary: guest-carts/{cartId}/items
  "/V1/guest-carts/{cartId}/items/{itemId}":
    put:
      tags:
        - guest-carts/{cartId}/items/{itemId}
      description: Add/update the specified cart item.
      operationId: PutV1GuestcartsCartIdItemsItemId
      consumes:
        - application/json
        - application/xml
      produces:
        - application/json
        - application/xml
      parameters:
        - name: cartId
          in: path
          type: string
          required: true
        - name: itemId
          in: path
          type: string
          required: true
        - name: PutV1GuestcartsCartIdItemsItemIdBody
          in: body
          schema:
            required:
              - cartItem
            properties:
              cartItem:
                $ref: "#/definitions/quote-data-cart-item-interfa

# --- truncated at 32 KB (161 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/adobe-suite/refs/heads/main/openapi/adobe-suite-commerce-rest-guest-openapi.yaml