Items

An Item in Swish belongs to a List and references a Shopify product/variant.

get
Authorizations
HTTPRequired
Query parameters
pagestringOptional

The page cursor

limitnumberOptional

Number of lists/items to return

Default: 50
querystringOptional

Item search query

Example: product:123,456 tag:saved-from-cart,saved-from-page
Responses
200

Returns all items as paginated response

application/json
get
/items
post
Authorizations
HTTPRequired
Body
productIdnumberRequired

The Shopify ID of the product

Example: 123
variantIdnumberOptional

The Shopify ID of the variant

Example: 456
quantitynumberOptional

The quantity of the item

Default: 1Example: 1
tagsstring[]Optional

Tags associated with the item (must contain only lowercase letters, numbers, hyphens or underscores)

Example: ["saved-from-cart"]
Responses
post
/items
delete
Authorizations
HTTPRequired
Body
itemIdsstring[]Required

The list of item IDs to delete

Example: ["507f1f77bcf86cd799439011","507f1f77bcf86cd799439022"]
Responses
delete
/items

No content

patch
Authorizations
HTTPRequired
Path parameters
itemIdstringRequired

The ID of the item

Example: 67a61d5561e4f9de302c02a1
Body
productIdnumberOptional

The Shopify ID of the product

Example: 123
variantIdnumberOptional

The Shopify ID of the variant

Example: 456
quantitynumberOptional

The quantity of the item

Default: 1Example: 2
Responses
200

The item has been successfully updated.

application/json
patch
/items/{itemId}
delete
Authorizations
HTTPRequired
Path parameters
itemIdstringRequired

The ID of the item

Example: 67a61d5561e4f9de302c02a1
Responses
delete
/items/{itemId}

No content

get
Authorizations
HTTPRequired
Path parameters
itemIdstringRequired

The ID of the item

Example: 67a61d5561e4f9de302c02a1
Responses
200

The item has been successfully found.

application/json
get
/items/{itemId}
put
Authorizations
HTTPRequired
Path parameters
itemIdstringRequired

The ID of the item

Example: 67a61d5561e4f9de302c02a1
Body
listIdsstring[]Required

The ID of the item to set the lists for

Example: ["67e2704d3c49af2fef03e054","67e2704d3c49af2fef03e054"]
Responses
200

The item has been successfully been added to the lists.

application/json
put
/items/{itemId}/lists

Last updated