---
title: "Update a collection"
method: PUT
path: "/open-api/v1.0/collections/{collectionId}"
tags: ["Collections"]
---

# Update a collection

`PUT /open-api/v1.0/collections/{collectionId}`

*Rate limit: 100 requests / 10 seconds per shop. See [Rate limiting](/guides/rate-limiting).*

Updates collection name, description, and/or product list

## Path parameters

- `collectionId` string, required

## Request body

- ComFourthwallOpenapiModelUpdateCollectionV1Request — Request to update a collection
  - `name` string
  - `description` string
  - `offerIds` string[] — List of product IDs to set in the collection

## Response `200`

OK

- ComFourthwallOpenapiModelCollectionV1
  - `id` string, required
  - `shopId` string, required
  - `name` string, required
  - `slug` string, required
  - `description` string, required
  - `available` boolean, required
  - `state` union, required
    - ComFourthwallOpenapiModelCollectionStateV1Archived — Archived collection state
      - `type` 'ARCHIVED', required
    - ComFourthwallOpenapiModelCollectionStateV1Hidden — Hidden collection state
      - `type` 'HIDDEN', required
      - `available` boolean, required
    - ComFourthwallOpenapiModelCollectionStateV1Private — Private collection state
      - `type` 'PRIVATE', required
      - `available` boolean, required
    - ComFourthwallOpenapiModelCollectionStateV1Public — Public collection state
      - `type` 'PUBLIC', required
      - `available` boolean, required
  - `offerIds` string[], required

## Other responses

- `400` — Possible errors: `COLLECTION_OFFERS_ALREADY_MODIFIED_ERROR`, `COLLECTION_UNSUPPORTED_UPDATE_DETAILS_OPERATION_ERROR`
- `404` — Possible errors: `COLLECTION_NOT_FOUND_BY_ID_ERROR`, `COLLECTION_OFFERS_NOT_FOUND`
- `429` — Rate limited: 100 requests / 10 seconds per shop.

---

[API](https://skmtc.net/fourthwall/apis/fourthwall-apis-2.md) · [All operations](https://skmtc.net/fourthwall/apis/fourthwall-apis-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fourthwall/fourthwall-apis-2/versions/ef273312f051/schema)