Requires write_collection access scope. More access scope
The Update Collection API allows users to update details of an existing collection by providing the collection ID and the desired updates in the request body. This API supports updates to various attributes, including the title, description, SEO details, associated products, and more.This API is especially useful for:
Modify collection details such as title, description, or handle.
Update the associated image, SEO metadata, and sorting order for merchandise.
Object containing details of the collection image.
image.src
string
//cdn.shoplazza.com/loading.png
Source URL of the collection image.
image.width
integer
100
Width of the collection image in pixels.
image.height
integer
100
Height of the collection image in pixels.
image.alt
string
""
Alt text for the collection image.
image.path
string
loading.png
File path of the collection image.
seo_title
string
seo_title
SEO title of the collection.
seo_description
string
Desc
SEO description of the collection.
seo_keywords
string
test
SEO keywords associated with the collection.
sort_order
string
title-asc
Merchandise sorting rules. Options include: manual (default), sales-desc, price-asc, price-desc, views-desc, vendor-asc, vendor-desc, created-desc, and more. (see Sort Order Options).
created_at
string
2024-04-16T10:31:12Z
Timestamp when the collection was created.
updated_at
string
2024-04-16T10:31:12Z
Timestamp when the collection was last updated.
Error Response
Error responses in the API can be represented using two different fields: errors and error. Both fields provide details about issues encountered during request processing. Below is an explanation of the fields with their respective examples and descriptions.
Field
Type
Example
Description
errors
Array
[ "Collection not found"]
A list of errors encountered during the request processing.
Field
Type
Example
Description
error
Array
"store is not active"
Indicates an error encountered during the process.
Error Details
Status Code
Message
Possible Reason
Example Response
400
Bad Request
Invalid input format or request structure (e.g., missing required fields or incorrect data types).
Bad Request
Unauthorized
The request is missing valid authentication credentials or the credentials provided are invalid.
Unauthorized
404
Collection Not Found
The collection ID provided in the request does not exist.
