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": 123.45,
  "title": "xyz789"
}

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"}

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
}

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": "abc123",
  "cart_items": [CartItemUpdateInput]
}

UpdateCartItemsOutput

Contains details about the cart after updating items.

Fields

Field Name
Description
cart - Cart!
The cart after updating products.

Example

{"cart": Cart}

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": "xyz789",
  "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": "xyz789",
  "quantity": 123.45
}

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": "xyz789",
  "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": "xyz789"
}

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": 987.65,
  "selected_options": ["abc123"]
}

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"
}

UrlRewrite

Contains URL rewrite details.

Fields

Field Name
Description
parameters - [HttpQueryParameter]
An array of request parameters.
url - String
The request URL.

Example

{
  "parameters": [HttpQueryParameter],
  "url": "xyz789"
}

UrlRewriteEntityTypeEnum

This enumeration defines the entity type.

Values

Enum Value
Description
CMS_PAGE
PRODUCT
CATEGORY

Example

""CMS_PAGE""

UseInLayeredNavigationOptions

Defines whether the attribute is filterable in layered navigation.

Values

Enum Value
Description
NO
FILTERABLE_WITH_RESULTS
FILTERABLE_NO_RESULT

Example

""NO""

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": 987,
  "pageSize": 123,
  "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": "xyz789", "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""

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": "xyz789",
  "payments_order_id": "abc123",
  "paypal_order_id": "abc123",
  "public_hash": "xyz789"
}

VaultTokenInput

Contains required input for payment methods with Vault support.

Input Fields

Input Field
Description
public_hash - String!
The public hash of the payment token.

Example

{"public_hash": "abc123"}

VirtualCartItem

An implementation for virtual product cart items.

Fields

Field Name
Description
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
id - String!
(Deprecated: Use uid instead.)
is_available - Boolean!
True if requested quantity is less than available stock, false otherwise.
max_qty - Float
Line item max qty in quote template
min_qty - Float
Line item min qty in quote template
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.
quantity - Float!
The quantity of this item in the cart.
uid - ID!
The unique ID for a CartItemInterface object.

Example

{
  "customizable_options": [SelectedCustomizableOption],
  "discount": [Discount],
  "errors": [CartItemError],
  "id": "xyz789",
  "is_available": true,
  "max_qty": 123.45,
  "min_qty": 123.45,
  "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
attribute_set_id - Int
The attribute set assigned to the product. (Deprecated: The field should not be used on the storefront.)
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.
color - Int
(Deprecated: Use the custom_attributes field instead.)
country_of_manufacture - String
The product's country of origin.
created_at - String
Timestamp indicating when the product was created. (Deprecated: The field should not be used on the storefront.)
crosssell_products - [ProductInterface]
An array of cross-sell products.
custom_attributesV2 - ProductCustomAttributes
Product custom attributes.
description - ComplexTextValue
Detailed information about the product. The value can include simple HTML tags.
gift_message_available - String
Indicates whether a gift message is available.
id - Int
The ID number assigned to the product. (Deprecated: Use the uid field instead.)
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. (Deprecated: Use the custom_attributes field instead.)
media_gallery - [MediaGalleryInterface]
An array of media gallery objects.
media_gallery_entries - [MediaGalleryEntry]
An array of MediaGalleryEntry objects. (Deprecated: Use media_gallery instead.)
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.
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 - ProductPrices
Indicates the price of an item. (Deprecated: Use price_range for product price information.)
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.
rating_summary - Float!
The average of all the ratings given to the product.
redirect_code - Int!
Contains 0 when there is no redirect error. A value of 301 indicates the URL of the requested resource has been changed permanently, while a value of 302 indicates a temporary redirect.
related_products - [ProductInterface]
An array of related products.
relative_url - String
The internal relative URL. If the specified URL is a redirect, the query returns the redirected URL, not the original.
review_count - Int!
The total count of all the reviews given to the product.
reviews - ProductReviews!
The list of products reviews.
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_from_date - String
The beginning date that a product has a special price. (Deprecated: The field should not be used on the storefront.)
special_price - Float
The discounted price of the product.
special_to_date - String
The end date for a product with a special price.
staged - Boolean!
Indicates whether the product is staged for a future campaign.
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.
tier_price - Float
The price when tier pricing is in effect and the items purchased threshold has been reached. (Deprecated: Use price_tiers for product tier price information.)
tier_prices - [ProductTierPrices]
An array of ProductTierPrices objects. (Deprecated: Use price_tiers for product tier price information.)
type - UrlRewriteEntityTypeEnum
One of PRODUCT, CATEGORY, or CMS_PAGE.
type_id - String
One of simple, virtual, bundle, downloadable, grouped, or configurable. (Deprecated: Use __typename instead.)
uid - ID!
The unique ID for a ProductInterface object.
updated_at - String
Timestamp indicating when the product was updated. (Deprecated: The field should not be used on the storefront.)
upsell_products - [ProductInterface]
An array of up-sell products.
url_key - String
The part of the URL that identifies the product
url_path - String
(Deprecated: Use product's canonical_url or url rewrites instead)
url_rewrites - [UrlRewrite]
URL rewrites list
url_suffix - String
The part of the product URL that is appended after the url key
websites - [Website]
An array of websites in which the product is available. (Deprecated: The field should not be used on the storefront.)

Example

{
  "attribute_set_id": 123,
  "canonical_url": "abc123",
  "categories": [CategoryInterface],
  "color": 123,
  "country_of_manufacture": "abc123",
  "created_at": "abc123",
  "crosssell_products": [ProductInterface],
  "custom_attributesV2": ProductCustomAttributes,
  "description": ComplexTextValue,
  "gift_message_available": "xyz789",
  "id": 987,
  "image": ProductImage,
  "is_returnable": "xyz789",
  "manufacturer": 987,
  "media_gallery": [MediaGalleryInterface],
  "media_gallery_entries": [MediaGalleryEntry],
  "meta_description": "xyz789",
  "meta_keyword": "xyz789",
  "meta_title": "xyz789",
  "name": "xyz789",
  "new_from_date": "abc123",
  "new_to_date": "abc123",
  "only_x_left_in_stock": 987.65,
  "options": [CustomizableOptionInterface],
  "options_container": "abc123",
  "price": ProductPrices,
  "price_range": PriceRange,
  "price_tiers": [TierPrice],
  "product_links": [ProductLinksInterface],
  "rating_summary": 123.45,
  "redirect_code": 987,
  "related_products": [ProductInterface],
  "relative_url": "xyz789",
  "review_count": 123,
  "reviews": ProductReviews,
  "short_description": ComplexTextValue,
  "sku": "xyz789",
  "small_image": ProductImage,
  "special_from_date": "xyz789",
  "special_price": 987.65,
  "special_to_date": "xyz789",
  "staged": false,
  "stock_status": "IN_STOCK",
  "swatch_image": "xyz789",
  "thumbnail": ProductImage,
  "tier_price": 123.45,
  "tier_prices": [ProductTierPrices],
  "type": "CMS_PAGE",
  "type_id": "abc123",
  "uid": 4,
  "updated_at": "xyz789",
  "upsell_products": [ProductInterface],
  "url_key": "abc123",
  "url_path": "abc123",
  "url_rewrites": [UrlRewrite],
  "url_suffix": "abc123",
  "websites": [Website]
}

VirtualProductCartItemInput

Defines a single product to add to the cart.

Input Fields

Input Field
Description
customizable_options - [CustomizableOptionInput]
An array that defines customizable options for the product.
data - CartItemInput!
An object containing the sku, quantity, and other relevant information about the product.

Example

{
  "customizable_options": [CustomizableOptionInput],
  "data": CartItemInput
}

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.
quantity - Float!
The amount added.
uid - ID!
The unique ID for the requisition list item.

Example

{
  "customizable_options": [SelectedCustomizableOption],
  "product": ProductInterface,
  "quantity": 987.65,
  "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.
quantity - Float!
The quantity of this wish list item.

Example

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

Website

Deprecated. It should not be used on the storefront. Contains information about a website.

Fields

Field Name
Description
code - String
A code assigned to the website to identify it. (Deprecated: The field should not be used on the storefront.)
default_group_id - String
The default group ID of the website. (Deprecated: The field should not be used on the storefront.)
id - Int
The ID number assigned to the website. (Deprecated: The field should not be used on the storefront.)
is_default - Boolean
Indicates whether this is the default website. (Deprecated: The field should not be used on the storefront.)
name - String
The website name. Websites use this name to identify it easier. (Deprecated: The field should not be used on the storefront.)
sort_order - Int
The attribute to use for sorting websites. (Deprecated: The field should not be used on the storefront.)

Example

{
  "code": "xyz789",
  "default_group_id": "xyz789",
  "id": 987,
  "is_default": true,
  "name": "xyz789",
  "sort_order": 987
}

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": "xyz789"
}

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 - [WishlistItem]
(Deprecated: Use the items_v2 field instead.)
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": [WishlistItem],
  "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": "abc123",
  "wishlistId": 4,
  "wishlistItemId": 4
}

WishlistCartUserInputErrorType

A list of possible error types.

Values

Enum Value
Description
PRODUCT_NOT_FOUND
NOT_SALABLE
INSUFFICIENT_STOCK
UNDEFINED

Example

""PRODUCT_NOT_FOUND""

WishlistItem

Contains details about a wish list item.

Fields

Field Name
Description
added_at - String
The time when the customer added the item to the wish list.
description - String
The customer's comment about this item.
id - Int
The unique ID for a WishlistItem object.
product - ProductInterface
Details about the wish list item.
qty - Float
The quantity of this wish list item

Example

{
  "added_at": "abc123",
  "description": "xyz789",
  "id": 123,
  "product": ProductInterface,
  "qty": 123.45
}

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": 123.45, "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": "abc123",
  "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.
quantity - Float!
The quantity of this wish list item.

Possible Types

Example

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

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": "abc123",
  "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
}

WishlistOutput

Deprecated: Use the Wishlist type instead.

Fields

Field Name
Description
items - [WishlistItem]
An array of items in the customer's wish list (Deprecated: Use the Wishlist.items field instead.)
items_count - Int
The number of items in the wish list. (Deprecated: Use the Wishlist.items_count field instead.)
name - String
When multiple wish lists are enabled, the name the customer assigns to the wishlist. (Deprecated: This field is related to Commerce functionality and is always null in Open Source.)
sharing_code - String
An encrypted code that links to the wish list. (Deprecated: Use the Wishlist.sharing_code field instead.)
updated_at - String
The time of the last modification to the wish list. (Deprecated: Use the Wishlist.updated_at field instead.)

Example

{
  "items": [WishlistItem],
  "items_count": 987,
  "name": "xyz789",
  "sharing_code": "xyz789",
  "updated_at": "xyz789"
}

WishlistVisibilityEnum

Defines the wish list visibility types.

Values

Enum Value
Description
PUBLIC
PRIVATE

Example

""PUBLIC""