**Version: 202601**

# Update collection

**PUT** `/openapi/2026-01/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 **fully replace** the collection. Must be valid UUIDs If provided, this field takes precedence over `add_product_ids` and `delete_product_ids`.
  - `add_product_ids` string[]

    List of product IDs to **add** to the existing collection. Must be valid UUIDs Ignored if `product_ids` is specified.
  - `delete_product_ids` string[]

    List of product IDs to **remove** from the existing collection. Must be valid UUIDs Ignored if `product_ids` is specified.
  - `tags` string[]

    List of tags for the collection

```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"
    ],
    "add_product_ids": [
      "string"
    ],
    "delete_product_ids": [
      "string"
    ],
    "tags": [
      "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

        The source URL of the image
      - `width` int32

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

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

        Alt text for the 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
    - `match_rules` object

      Smart collection match rules

      - `disjunctive` boolean

        Whether conditions are disjunctive (OR)
      - `rule_modules` object[]

        List of rule modules

        *   Array \[

        - `disjunctive` boolean

          Whether conditions are disjunctive (OR)
        - `rules` object[]

          List of rules in this module

          *   Array \[

          - `column` string

            Column
          - `relation` string

            Relation
          - `condition` string

            Condition
          *   \]
        *   \]
    - `tags` string[]

      List of tags for the collection
    - `product_count` int64

      Number of products in the collection

```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",
      "match_rules": {
        "disjunctive": true,
        "rule_modules": [
          {
            "disjunctive": true,
            "rules": [
              {
                "column": "string",
                "relation": "string",
                "condition": "string"
              }
            ]
          }
        ]
      },
      "tags": [
        "string"
      ],
      "product_count": 0
    }
  }
}
```