**Version: 202506**

# Update collection

**PUT** `/openapi/2025-06/collections/:id`

Allows users to update details of an existing collection by providing the collection ID and the desired updates in the request body.

## Request

**Path Parameters**

- `id` string (required)

  Collection ID. Must be a valid UUID

**application/json**

**Body | Example**

**Body (required)**

- `collection` object (required)

  Collection

  - `title` string

    The name of the collection
  - `handle` string

    A unique URL-friendly identifier for the collection
  - `description` string

    The description of the collection
  - `image` object

    Image

    - `src` string (required)

      The source URL of the collection image
    - `width` int32

      The width of the collection image in pixels
    - `height` int32

      The height of the collection image in pixels
    - `alt` string

      Alt text for the collection image
  - `seo_title` string

    The SEO title for the collection
  - `seo_keywords` string[]

    The keywords for SEO
  - `seo_description` string

    The SEO description for the collection
  - `sort_order` string

    Merchandise sorting rules. Options include: manual (default), sales-desc, price-asc, price-desc, views-desc, vendor-asc, vendor-desc, created-desc, intelligent and more

    **Default value:** `manual`
  - `product_ids` string[]

    List of product IDs to include in the collection. Must be valid UUIDs

```json
{
  "collection": {
    "title": "string",
    "handle": "string",
    "description": "string",
    "image": {
      "src": "string",
      "width": 0,
      "height": 0,
      "alt": "string"
    },
    "seo_title": "string",
    "seo_keywords": [
      "string"
    ],
    "seo_description": "string",
    "sort_order": "manual",
    "product_ids": [
      "string"
    ]
  }
}
```

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `collection` object

    Collection

    - `id` string

      Collection ID
    - `title` string

      Title
    - `description` string

      Description
    - `handle` string

      URL-friendly identifier (handle)
    - `smart` boolean

      Smart
    - `image` object

      Image

      - `src` string

        Image source URL
      - `width` int32

        Width dimension
      - `height` int32

        Height dimension
      - `alt` string

        Alt text for image
    - `seo_title` string

      SEO title
    - `seo_keywords` string[]

      SEO keywords
    - `seo_description` string

      SEO description
    - `sort_order` string

      Sort order
    - `created_at` string

      Creation timestamp, in ISO-8601 format
    - `updated_at` string

      Last update timestamp, in ISO-8601 format

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "collection": {
      "id": "string",
      "title": "string",
      "description": "string",
      "handle": "string",
      "smart": true,
      "image": {
        "src": "string",
        "width": 0,
        "height": 0,
        "alt": "string"
      },
      "seo_title": "string",
      "seo_keywords": [
        "string"
      ],
      "seo_description": "string",
      "sort_order": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  }
}
```
