Types

TaxItem

Contains tax item details.

Fields

Field Name
Description
amount - Money!
The amount of tax applied to the item.
rate - Float!
The rate used to calculate the tax.
title - String!
A title that describes the tax.

Example

{
  "amount": Money,
  "rate": 987.65,
  "title": "abc123"
}

TaxWrappingEnum

Values

Enum Value
Description
DISPLAY_EXCLUDING_TAX
DISPLAY_INCLUDING_TAX
DISPLAY_TYPE_BOTH

Example

""DISPLAY_EXCLUDING_TAX""

TextSwatchData

Fields

Field Name
Description
value - String
The value can be represented as color (HEX code), image link, or text.

Example

{"value": "xyz789"}

ThreeDSMode

3D Secure mode.

Values

Enum Value
Description
OFF
SCA_WHEN_REQUIRED
SCA_ALWAYS

Example

""OFF""

TierPrice

Defines a price based on the quantity purchased.

Fields

Field Name
Description
discount - ProductDiscount
The price discount that this tier represents.
final_price - Money
The price of the product at this tier.
quantity - Float
The minimum number of items that must be purchased to qualify for this price tier.

Example

{
  "discount": ProductDiscount,
  "final_price": Money,
  "quantity": 123.45
}

UnassignChildCompanyInput

Defines the input schema for unassigning a child company from its parent company.

Input Fields

Input Field
Description
child_company_id - ID!
The unique ID of the child company.

Example

{"child_company_id": 4}

UnassignChildCompanyOutput

Contains the response to the request to unassign a child company.

Fields

Field Name
Description
company_hierarchy - CompanyHierarchy!
The updated company relation hierarchy for the current company.

Example

{"company_hierarchy": CompanyHierarchy}

UnitConfigInput

Input Fields

Input Field
Description
unitName - String
storefrontLabel - String
pagePlacement - String
displayNumber - Int
pageType - String
unitStatus - String
typeId - String
filterRules - [FilterRuleInput]

Example

{
  "unitName": "xyz789",
  "storefrontLabel": "xyz789",
  "pagePlacement": "xyz789",
  "displayNumber": 123,
  "pageType": "xyz789",
  "unitStatus": "abc123",
  "typeId": "xyz789",
  "filterRules": [FilterRuleInput]
}

UpdateCartItemsInput

Modifies the specified items in the cart.

Input Fields

Input Field
Description
cart_id - String!
The unique ID of a Cart object.
cart_items - [CartItemUpdateInput]!
An array of items to be updated.

Example

{
  "cart_id": "xyz789",
  "cart_items": [CartItemUpdateInput]
}

UpdateCartItemsOutput

Contains details about the cart after updating items.

Fields

Field Name
Description
cart - Cart!
The cart after updating products.
errors - [CartUserInputError]!
Contains errors encountered while updating an item to the cart.

Example

{
  "cart": Cart,
  "errors": [CartUserInputError]
}

UpdateCompanyOutput

Contains the response to the request to update the company.

Fields

Field Name
Description
company - Company!
The updated company instance.

Example

{"company": Company}

UpdateCompanyRoleOutput

Contains the response to the request to update the company role.

Fields

Field Name
Description
role - CompanyRole!
The updated company role instance.

Example

{"role": CompanyRole}

UpdateCompanyStructureOutput

Contains the response to the request to update the company structure.

Fields

Field Name
Description
company - Company!
The updated company instance.

Example

{"company": Company}

UpdateCompanyTeamOutput

Contains the response to the request to update a company team.

Fields

Field Name
Description
team - CompanyTeam!
The updated company team instance.

Example

{"team": CompanyTeam}

UpdateCompanyUserOutput

Contains the response to the request to update the company user.

Fields

Field Name
Description
user - Customer!
The updated company user instance.

Example

{"user": Customer}

UpdateGiftRegistryInput

Defines updates to a GiftRegistry object.

Input Fields

Input Field
Description
dynamic_attributes - [GiftRegistryDynamicAttributeInput]
Additional attributes specified as a code-value pair. Unspecified dynamic attributes are not changed.
event_name - String
The updated name of the event.
message - String
The updated message describing the event.
privacy_settings - GiftRegistryPrivacySettings
Indicates whether the gift registry is PRIVATE or PUBLIC.
shipping_address - GiftRegistryShippingAddressInput
The updated shipping address for all gift registry items.
status - GiftRegistryStatus
Indicates whether the gift registry is ACTIVE or INACTIVE.

Example

{
  "dynamic_attributes": [
    GiftRegistryDynamicAttributeInput
  ],
  "event_name": "abc123",
  "message": "abc123",
  "privacy_settings": "PRIVATE",
  "shipping_address": GiftRegistryShippingAddressInput,
  "status": "ACTIVE"
}

UpdateGiftRegistryItemInput

Defines updates to an item in a gift registry.

Input Fields

Input Field
Description
gift_registry_item_uid - ID!
The unique ID of a giftRegistryItem object.
note - String
The updated description of the item.
quantity - Float!
The updated quantity of the gift registry item.

Example

{
  "gift_registry_item_uid": 4,
  "note": "abc123",
  "quantity": 987.65
}

UpdateGiftRegistryItemsOutput

Contains the results of a request to update gift registry items.

Fields

Field Name
Description
gift_registry - GiftRegistry
The gift registry after updating updating items.

Example

{"gift_registry": GiftRegistry}

UpdateGiftRegistryOutput

Contains the results of a request to update a gift registry.

Fields

Field Name
Description
gift_registry - GiftRegistry
The updated gift registry.

Example

{"gift_registry": GiftRegistry}

UpdateGiftRegistryRegistrantInput

Defines updates to an existing registrant.

Input Fields

Input Field
Description
dynamic_attributes - [GiftRegistryDynamicAttributeInput]
As a result of the update, only the values of provided attributes will be affected. If the attribute is missing in the request, its value will not be changed.
email - String
The updated email address of the registrant.
firstname - String
The updated first name of the registrant.
gift_registry_registrant_uid - ID!
The unique ID of a giftRegistryRegistrant object.
lastname - String
The updated last name of the registrant.

Example

{
  "dynamic_attributes": [
    GiftRegistryDynamicAttributeInput
  ],
  "email": "abc123",
  "firstname": "abc123",
  "gift_registry_registrant_uid": 4,
  "lastname": "abc123"
}

UpdateGiftRegistryRegistrantsOutput

Contains the results a request to update registrants.

Fields

Field Name
Description
gift_registry - GiftRegistry
The gift registry after updating registrants.

Example

{"gift_registry": GiftRegistry}

UpdateNegotiableQuoteItemsQuantityOutput

Contains the updated negotiable quote.

Fields

Field Name
Description
quote - NegotiableQuote
The updated negotiable quote.

Example

{"quote": NegotiableQuote}

UpdateNegotiableQuoteQuantitiesInput

Specifies the items to update.

Input Fields

Input Field
Description
items - [NegotiableQuoteItemQuantityInput]!
An array of items to update.
quote_uid - ID!
The unique ID of a NegotiableQuote object.

Example

{
  "items": [NegotiableQuoteItemQuantityInput],
  "quote_uid": "4"
}

UpdateNegotiableQuoteTemplateItemsQuantityOutput

Contains the updated negotiable quote template.

Fields

Field Name
Description
quote_template - NegotiableQuoteTemplate
The updated negotiable quote template.

Example

{"quote_template": NegotiableQuoteTemplate}

UpdateNegotiableQuoteTemplateQuantitiesInput

Specifies the items to update.

Input Fields

Input Field
Description
items - [NegotiableQuoteTemplateItemQuantityInput]!
An array of items to update.
template_id - ID!
The unique ID of a NegotiableQuoteTemplate object.

Example

{
  "items": [NegotiableQuoteTemplateItemQuantityInput],
  "template_id": "4"
}

UpdateProductsInWishlistOutput

Contains the customer's wish list and any errors encountered.

Fields

Field Name
Description
user_errors - [WishListUserInputError]!
An array of errors encountered while updating products in a wish list.
wishlist - Wishlist!
Contains the wish list with all items that were successfully updated.

Example

{
  "user_errors": [WishListUserInputError],
  "wishlist": Wishlist
}

UpdatePurchaseOrderApprovalRuleInput

Defines the changes to be made to an approval rule.

Input Fields

Input Field
Description
applies_to - [ID]
An updated list of company user role IDs to which this purchase order approval rule should be applied. When an empty array is provided, the rule is applied to all user roles in the system, including those created in the future.
approvers - [ID]
An updated list of B2B user roles that can approve this purchase order approval rule.
condition - CreatePurchaseOrderApprovalRuleConditionInput
The updated condition of the purchase order approval rule.
description - String
The updated approval rule description.
name - String
The updated approval rule name.
status - PurchaseOrderApprovalRuleStatus
The updated status of the purchase order approval rule.
uid - ID!
Unique identifier for the purchase order approval rule.

Example

{
  "applies_to": ["4"],
  "approvers": [4],
  "condition": CreatePurchaseOrderApprovalRuleConditionInput,
  "description": "abc123",
  "name": "abc123",
  "status": "ENABLED",
  "uid": 4
}

UpdateRequisitionListInput

An input object that defines which requistion list characteristics to update.

Input Fields

Input Field
Description
description - String
The updated description of the requisition list.
name - String!
The new name of the requisition list.

Example

{
  "description": "xyz789",
  "name": "abc123"
}

UpdateRequisitionListItemsInput

Defines which items in a requisition list to update.

Input Fields

Input Field
Description
entered_options - [EnteredOptionInput]
An array of customer-entered options.
item_id - ID!
The ID of the requisition list item to update.
quantity - Float
The new quantity of the item.
selected_options - [String]
An array of selected option IDs.

Example

{
  "entered_options": [EnteredOptionInput],
  "item_id": 4,
  "quantity": 123.45,
  "selected_options": ["xyz789"]
}

UpdateRequisitionListItemsOutput

Output of the request to update items in the specified requisition list.

Fields

Field Name
Description
requisition_list - RequisitionList
The requisition list after updating items.

Example

{"requisition_list": RequisitionList}

UpdateRequisitionListOutput

Output of the request to rename the requisition list.

Fields

Field Name
Description
requisition_list - RequisitionList
The renamed requisition list.

Example

{"requisition_list": RequisitionList}

UpdateWishlistOutput

Contains the name and visibility of an updated wish list.

Fields

Field Name
Description
name - String!
The wish list name.
uid - ID!
The unique ID of a Wishlist object.
visibility - WishlistVisibilityEnum!
Indicates whether the wish list is public or private.

Example

{
  "name": "abc123",
  "uid": "4",
  "visibility": "PUBLIC"
}

UserCompaniesInput

Defines the input for returning matching companies the customer is assigned to.

Input Fields

Input Field
Description
currentPage - Int
Specifies which page of results to return. The default value is 1.
pageSize - Int
Specifies the maximum number of results to return at once. This attribute is optional.
sort - [CompaniesSortInput]
Defines the sorting of the results.

Example

{
  "currentPage": 123,
  "pageSize": 987,
  "sort": [CompaniesSortInput]
}

UserCompaniesOutput

An object that contains a list of companies customer is assigned to.

Fields

Field Name
Description
items - [CompanyBasicInfo]!
An array of companies customer is assigned to.
page_info - SearchResultPageInfo!
Provides navigation for the query response.

Example

{
  "items": [CompanyBasicInfo],
  "page_info": SearchResultPageInfo
}

ValidatePurchaseOrderError

Contains details about a failed validation attempt.

Fields

Field Name
Description
message - String!
The returned error message.
type - ValidatePurchaseOrderErrorType!
Error type.

Example

{"message": "abc123", "type": "NOT_FOUND"}

ValidatePurchaseOrderErrorType

Values

Enum Value
Description
NOT_FOUND
OPERATION_NOT_APPLICABLE
COULD_NOT_SAVE
NOT_VALID_DATA
UNDEFINED

Example

""NOT_FOUND""

ValidatePurchaseOrdersInput

Defines the purchase orders to be validated.

Input Fields

Input Field
Description
purchase_order_uids - [ID]!
An array of the purchase order IDs.

Example

{"purchase_order_uids": ["4"]}

ValidatePurchaseOrdersOutput

Contains the results of validation attempts.

Fields

Field Name
Description
errors - [ValidatePurchaseOrderError]!
An array of error messages encountered while performing the operation.
purchase_orders - [PurchaseOrder]!
An array of the purchase orders in the request.

Example

{
  "errors": [ValidatePurchaseOrderError],
  "purchase_orders": [PurchaseOrder]
}

ValidationRule

Defines a customer attribute validation rule.

Fields

Field Name
Description
name - ValidationRuleEnum
Validation rule name applied to a customer attribute.
value - String
Validation rule value.

Example

{
  "name": "DATE_RANGE_MAX",
  "value": "abc123"
}

ValidationRuleEnum

List of validation rule names applied to a customer attribute.

Values

Enum Value
Description
DATE_RANGE_MAX
DATE_RANGE_MIN
FILE_EXTENSIONS
INPUT_VALIDATION
MAX_TEXT_LENGTH
MIN_TEXT_LENGTH
MAX_FILE_SIZE
MAX_IMAGE_HEIGHT
MAX_IMAGE_WIDTH

Example

""DATE_RANGE_MAX""

VaultConfigOutput

Retrieves the vault configuration

Fields

Field Name
Description
credit_card - VaultCreditCardConfig
Credit card vault method configuration

Example

{"credit_card": VaultCreditCardConfig}

VaultCreditCardConfig

Fields

Field Name
Description
is_vault_enabled - Boolean
Is vault enabled
sdk_params - [SDKParams]
The parameters required to load the Paypal JS SDK
three_ds_mode - ThreeDSMode
3DS mode

Example

{
  "is_vault_enabled": true,
  "sdk_params": [SDKParams],
  "three_ds_mode": "OFF"
}

VaultMethodInput

Vault payment inputs

Input Fields

Input Field
Description
payment_source - String
The payment source for the payment method
payments_order_id - String
The payment services order ID
paypal_order_id - String
PayPal order ID
public_hash - String
The public hash of the token.

Example

{
  "payment_source": "abc123",
  "payments_order_id": "xyz789",
  "paypal_order_id": "xyz789",
  "public_hash": "xyz789"
}

VaultSetupTokenInput

The payment source information

Input Fields

Input Field
Description
payment_source - PaymentSourceInput!
The payment source information

Example

{"payment_source": PaymentSourceInput}

ViewHistory

User view history

Input Fields

Input Field
Description
date - DateTime
sku - String!

Example

{
  "date": "2007-12-03T10:15:30Z",
  "sku": "abc123"
}

ViewHistoryInput

User view history

Input Fields

Input Field
Description
dateTime - DateTime
sku - String!

Example

{
  "dateTime": "2007-12-03T10:15:30Z",
  "sku": "xyz789"
}

VirtualCartItem

An implementation for virtual product cart items.

Fields

Field Name
Description
backorder_message - String
Customer-facing hint when the line is salable on notify backorders with insufficient physical quantity; null otherwise.
custom_attributes - [CustomAttribute]
The custom attributes for the cart item
customizable_options - [SelectedCustomizableOption]!
An array containing customizable options the shopper selected.
discount - [Discount]
Contains discount for quote line item.
errors - [CartItemError]
An array of errors encountered while loading the cart item
is_available - Boolean!
True if requested quantity is less than available stock, false otherwise. (Deprecated: Use is_salable instead. It indicates whether the line can be purchased, including backorder configuration.)
is_salable - Boolean!
True when the item can be purchased and should not block checkout: stock status is in stock and either physical quantity covers the requested quantity or backorders are allowed.
max_qty - Float
Line item max qty in quote template
min_qty - Float
Line item min qty in quote template
not_available_message - String
Shortage or unavailability message for the line; null when the item is salable.
note_from_buyer - [ItemNote]
The buyer's quote line item note.
note_from_seller - [ItemNote]
The seller's quote line item note.
prices - CartItemPrices
Contains details about the price of the item, including taxes and discounts.
product - ProductInterface!
Details about an item in the cart. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The quantity of this item in the cart.
uid - ID!
The unique ID for a CartItemInterface object.

Example

{
  "backorder_message": "abc123",
  "custom_attributes": [CustomAttribute],
  "customizable_options": [SelectedCustomizableOption],
  "discount": [Discount],
  "errors": [CartItemError],
  "is_available": false,
  "is_salable": true,
  "max_qty": 987.65,
  "min_qty": 123.45,
  "not_available_message": "abc123",
  "note_from_buyer": [ItemNote],
  "note_from_seller": [ItemNote],
  "prices": CartItemPrices,
  "product": ProductInterface,
  "quantity": 123.45,
  "uid": 4
}

VirtualProduct

Defines a virtual product, which is a non-tangible product that does not require shipping and is not kept in inventory.

Fields

Field Name
Description
canonical_url - String
The relative canonical URL. This value is returned only if the system setting 'Use Canonical Link Meta Tag For Products' is enabled.
categories - [CategoryInterface]
The categories assigned to a product.
country_of_manufacture - String
The product's country of origin.
crosssell_products - [ProductInterface]
Crosssell Products
custom_attributesV2 - ProductCustomAttributes
Product custom attributes.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
gift_message_available - Boolean!
Returns a value indicating gift message availability for the product.
gift_wrapping_available - Boolean!
Returns a value indicating gift wrapping availability for the product.
gift_wrapping_price - Money
Returns value and currency indicating gift wrapping price for the product.
image - ProductImage
The relative path to the main image on the product page.
is_returnable - String
Indicates whether the product can be returned.
manufacturer - Int
A number representing the product's manufacturer.
max_sale_qty - Float
Maximum Qty Allowed in Shopping Cart
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
meta_description - String
A brief overview of the product for search results listings, maximum 255 characters.
meta_keyword - String
A comma-separated list of keywords that are visible only to search engines.
meta_title - String
A string that is displayed in the title bar and tab of the browser and in search results lists.
min_sale_qty - Float
Minimum Qty Allowed in Shopping Cart
name - String
The product name. Customers use this name to identify the product.
new_from_date - String
The beginning date for new product listings, and determines if the product is featured as a new product.
new_to_date - String
The end date for new product listings.
only_x_left_in_stock - Float
Product stock only x left count
options - [CustomizableOptionInterface]
An array of options for a customizable product.
options_container - String
If the product has multiple options, determines where they appear on the product page.
price_range - PriceRange!
The range of prices for the product
price_tiers - [TierPrice]
An array of TierPrice objects.
product_links - [ProductLinksInterface]
An array of ProductLinks objects.
quantity - Float
Quantity of available stock
related_products - [ProductInterface]
An array of products to be displayed in a Related Products block.
short_description - ComplexTextValue
A short description of the product. Its use depends on the theme.
sku - String
A number or code assigned to a product to identify the product, options, price, and manufacturer.
small_image - ProductImage
The relative path to the small image, which is used on catalog pages.
special_price - Float
The discounted price of the product.
special_to_date - String
The end date for a product with a special price.
stock_status - ProductStockStatus
Stock status of the product
swatch_image - String
The file name of a swatch image.
thumbnail - ProductImage
The relative path to the product's thumbnail image.
uid - ID!
The unique ID for a ProductInterface object.
upsell_products - [ProductInterface]
Upsell Products
url_key - String
The part of the URL that identifies the product

Example

{
  "canonical_url": "xyz789",
  "categories": [CategoryInterface],
  "country_of_manufacture": "abc123",
  "crosssell_products": [ProductInterface],
  "custom_attributesV2": ProductCustomAttributes,
  "description": ComplexTextValue,
  "gift_message_available": false,
  "gift_wrapping_available": false,
  "gift_wrapping_price": Money,
  "image": ProductImage,
  "is_returnable": "abc123",
  "manufacturer": 123,
  "max_sale_qty": 123.45,
  "media_gallery": [MediaGalleryInterface],
  "meta_description": "abc123",
  "meta_keyword": "abc123",
  "meta_title": "xyz789",
  "min_sale_qty": 987.65,
  "name": "xyz789",
  "new_from_date": "xyz789",
  "new_to_date": "xyz789",
  "only_x_left_in_stock": 987.65,
  "options": [CustomizableOptionInterface],
  "options_container": "xyz789",
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "quantity": 123.45,
  "related_products": [ProductInterface],
  "short_description": ComplexTextValue,
  "sku": "abc123",
  "small_image": ProductImage,
  "special_price": 987.65,
  "special_to_date": "abc123",
  "stock_status": "IN_STOCK",
  "swatch_image": "abc123",
  "thumbnail": ProductImage,
  "uid": 4,
  "upsell_products": [ProductInterface],
  "url_key": "xyz789"
}

VirtualRequisitionListItem

Contains details about virtual products added to a requisition list.

Fields

Field Name
Description
customizable_options - [SelectedCustomizableOption]!
Selected custom options for an item in the requisition list.
product - ProductInterface!
Details about a requisition list item. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The amount added.
sku - String!
The product SKU.
uid - ID!
The unique ID for the requisition list item.

Example

{
  "customizable_options": [SelectedCustomizableOption],
  "product": ProductInterface,
  "quantity": 123.45,
  "sku": "xyz789",
  "uid": "4"
}

VirtualWishlistItem

Contains a virtual product wish list item.

Fields

Field Name
Description
added_at - String!
The date and time the item was added to the wish list.
customizable_options - [SelectedCustomizableOption]!
Custom options selected for the wish list item.
description - String
The description of the item.
id - ID!
The unique ID for a WishlistItemInterface object.
product - ProductInterface!
Product details of the wish list item. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The quantity of this wish list item.

Example

{
  "added_at": "abc123",
  "customizable_options": [SelectedCustomizableOption],
  "description": "xyz789",
  "id": "4",
  "product": ProductInterface,
  "quantity": 123.45
}

WishListUserInputError

An error encountered while performing operations with WishList.

Fields

Field Name
Description
code - WishListUserInputErrorType!
A wish list-specific error code.
message - String!
A localized error message.

Example

{
  "code": "PRODUCT_NOT_FOUND",
  "message": "abc123"
}

WishListUserInputErrorType

A list of possible error types.

Values

Enum Value
Description
PRODUCT_NOT_FOUND
UNDEFINED

Example

""PRODUCT_NOT_FOUND""

Wishlist

Contains a customer wish list.

Fields

Field Name
Description
id - ID
The unique ID for a Wishlist object.
items_count - Int
The number of items in the wish list.
items_v2 - WishlistItems
An array of items in the customer's wish list.
name - String
The name of the wish list.
sharing_code - String
An encrypted code that Magento uses to link to the wish list.
updated_at - String
The time of the last modification to the wish list.
visibility - WishlistVisibilityEnum!
Indicates whether the wish list is public or private.

Example

{
  "id": "4",
  "items_count": 123,
  "items_v2": WishlistItems,
  "name": "xyz789",
  "sharing_code": "xyz789",
  "updated_at": "abc123",
  "visibility": "PUBLIC"
}

WishlistCartUserInputError

Contains details about errors encountered when a customer added wish list items to the cart.

Fields

Field Name
Description
code - WishlistCartUserInputErrorType!
An error code that describes the error encountered.
message - String!
A localized error message.
wishlistId - ID!
The unique ID of the Wishlist object containing an error.
wishlistItemId - ID!
The unique ID of the wish list item containing an error.

Example

{
  "code": "PRODUCT_NOT_FOUND",
  "message": "xyz789",
  "wishlistId": "4",
  "wishlistItemId": 4
}

WishlistCartUserInputErrorType

A list of possible error types.

Values

Enum Value
Description
PRODUCT_NOT_FOUND
NOT_SALABLE
INSUFFICIENT_STOCK
UNDEFINED
REQUIRED_PARAMETER_MISSING

Example

""PRODUCT_NOT_FOUND""

WishlistItemCopyInput

Specifies the IDs of items to copy and their quantities.

Input Fields

Input Field
Description
quantity - Float
The quantity of this item to copy to the destination wish list. This value can't be greater than the quantity in the source wish list.
wishlist_item_id - ID!
The unique ID of the WishlistItemInterface object to be copied.

Example

{"quantity": 987.65, "wishlist_item_id": 4}

WishlistItemInput

Defines the items to add to a wish list.

Input Fields

Input Field
Description
entered_options - [EnteredOptionInput]
An array of options that the customer entered.
parent_sku - String
For complex product types, the SKU of the parent product.
quantity - Float!
The amount or number of items to add.
selected_options - [ID]
An array of strings corresponding to options the customer selected.
sku - String!
The SKU of the product to add. For complex product types, specify the child product SKU.

Example

{
  "entered_options": [EnteredOptionInput],
  "parent_sku": "xyz789",
  "quantity": 987.65,
  "selected_options": [4],
  "sku": "xyz789"
}

WishlistItemInterface

The interface for wish list items.

Fields

Field Name
Description
added_at - String!
The date and time the item was added to the wish list.
customizable_options - [SelectedCustomizableOption]!
Custom options selected for the wish list item.
description - String
The description of the item.
id - ID!
The unique ID for a WishlistItemInterface object.
product - ProductInterface!
Product details of the wish list item. (Deprecated: Product information is part of a composable Catalog Service.)
quantity - Float!
The quantity of this wish list item.

Possible Types

Example

{
  "added_at": "xyz789",
  "customizable_options": [SelectedCustomizableOption],
  "description": "abc123",
  "id": "4",
  "product": ProductInterface,
  "quantity": 123.45
}

WishlistItemMoveInput

Specifies the IDs of the items to move and their quantities.

Input Fields

Input Field
Description
quantity - Float
The quantity of this item to move to the destination wish list. This value can't be greater than the quantity in the source wish list.
wishlist_item_id - ID!
The unique ID of the WishlistItemInterface object to be moved.

Example

{
  "quantity": 987.65,
  "wishlist_item_id": "4"
}

WishlistItemUpdateInput

Defines updates to items in a wish list.

Input Fields

Input Field
Description
description - String
Customer-entered comments about the item.
entered_options - [EnteredOptionInput]
An array of options that the customer entered.
quantity - Float
The new amount or number of this item.
selected_options - [ID]
An array of strings corresponding to options the customer selected.
wishlist_item_id - ID!
The unique ID for a WishlistItemInterface object.

Example

{
  "description": "xyz789",
  "entered_options": [EnteredOptionInput],
  "quantity": 123.45,
  "selected_options": ["4"],
  "wishlist_item_id": 4
}

WishlistItems

Contains an array of items in a wish list.

Fields

Field Name
Description
items - [WishlistItemInterface]!
A list of items in the wish list.
page_info - SearchResultPageInfo
Contains pagination metadata.

Example

{
  "items": [WishlistItemInterface],
  "page_info": SearchResultPageInfo
}

WishlistVisibilityEnum

Defines the wish list visibility types.

Values

Enum Value
Description
PUBLIC
PRIVATE

Example

""PUBLIC""