---
title: "Update collection"
method: PATCH
path: "/api/v1/collections/{collectionId}"
tags: ["collections"]
---

# Update collection

`PATCH /api/v1/collections/{collectionId}`

Update the metadata of an existing collection by its ID.

    You can update the collection name or other editable fields.

    **Use cases:**
    - Renaming collections
    - Managing collections in admin dashboards
    - Bulk updating collection metadata

## Path parameters

- `collectionId` string, required

## Request body

- object
  - `name` string, required

## Response `200`

This response returns the details of the requested collection.

- object — This response returns the details of the requested collection.
  - `id` string, required
  - `isDefault` boolean
  - `workspace` string, required
  - `creator` string, required
  - `updater` string
  - `teams` string[], required
  - `created` string, date-time, required
  - `sortOrder` string
  - `name` string, required
  - `updated` string, date-time, required
  - `isDeleted` boolean
  - `emoji` object
    - `id` string, required
    - `native` string, required
    - `unified` string, required
  - `deletedAt` number

## Other responses

- `400` — This response indicates that the request was malformed or contained invalid parameters.
- `401` — This response indicates that the client must authenticate to access the requested resource.
- `403` — This response indicates that the client does not have permission to access the requested resource.
- `404` — This response indicates that the requested resource could not be found.

---

[API](https://skmtc.net/excalidraw/apis/excalidraw-api.md) · [All operations](https://skmtc.net/excalidraw/apis/excalidraw-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/excalidraw/excalidraw-api/revisions/c1404d1545ba/schema)