Update Collection
Collections
Update Collection
Update an existing collection
PUT
Update Collection
Update Collection
Updates an existing collection. Only provided fields are updated. Requires thewrite_products scope.
Request
Path Parameters
The unique collection ID to update
Body Parameters
All parameters are optional. Only the four fields below are applied; any other field in the request body is accepted but ignored.The collection title
Collection description (supports HTML). This is the field that updates the
collection body — it is returned as
body_html (and description) on read.URL-safe handle
URL of the collection featured image. Pass
null to remove.Response
The response is a bare object keyed bycollection containing the updated,
Shopify-shaped collection object (the same shape returned by the read
endpoints). There is no { status, data } envelope.
The updated collection object
Example Response
Errors
Errors are returned as a Shopify-style{ "errors": { "base": ["..."] } } body
with the corresponding HTTP status code.
| Status | Description |
|---|---|
401 | Invalid or missing access token |
403 | App doesn’t have the write_products scope |
404 | Collection with the specified ID does not exist |