---
title: "Update a collection"
method: PUT
path: "/collections/{id}"
tags: ["Collections"]
---

# Update a collection

`PUT /collections/{id}`

Update an existing collection

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string, required — Name of the collection
  - `description` string, required — Description of the collection
  - `slug` string, required — URL-friendly slug (lowercase alphanumeric with hyphens)
  - `visibility` 'PUBLIC' | 'UNLISTED', required — Visibility of the collection

## Response `200`

Collection updated successfully

- object
  - `data` Collection, required
    - `id` string, required — Unique identifier for the collection
    - `name` string, required — Name of the collection
    - `description` string — Description of the collection
    - `slug` string, required — URL-friendly slug identifier
    - `visibility` 'PUBLIC' | 'UNLISTED', required — Visibility of the collection
    - `userId` string, required — ID of the user who owns the collection
    - `createdAt` string, date-time — Creation timestamp
    - `updatedAt` string, date-time — Last update timestamp
    - `books` Book[] — Books in the collection
      - `id` string, required — Unique identifier for the book
      - `slug` string, required — URL-friendly identifier
      - `primaryName` string, required — Primary name of the book
      - `secondaryName` string — Secondary name of the book
      - `author` Author, required
        - `id` string, required — Unique identifier for the author
        - `slug` string, required — URL-friendly identifier
        - `primaryName` string, required — Primary name of the author
        - `secondaryName` string — Secondary name of the author
        - `year` integer — Year of birth/death
        - `locations` Location[]
          - `id` string, required — Unique identifier for the location
          - `name` string, required — Name of the location
          - `region` Region
            - `id` string, required — Unique identifier for the region
            - `slug` string, required — URL-friendly identifier
            - `name` string, required — Name of the region
      - `year` integer — Year of publication
      - `versions` BookVersion[]
        - `id` string, required — Unique identifier for the version
        - `value` string, required — Version identifier
        - `source` string, required — Source of the version
        - `aiSupported` boolean — Whether AI is supported for this version
        - `keywordSupported` boolean — Whether keyword search is supported

## Other responses

- `401` — Unauthorized - authentication required
- `404` — Collection not found

---

[API](https://skmtc.dev/usul/apis/usul-api.md) · [All operations](https://skmtc.dev/usul/apis/usul-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usul/usul-api/revisions/b4f2df3e5842/schema)