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

# Update a collection

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

## Request

- Base URL: `https://numonic.ai`
- URL: `https://numonic.ai/api/v1/collections/{collectionH}`
- Auth: API key in header `x-api-key`

Update collection display name, description, icon, or color.

## Path parameters

- `collectionH` string, required: Collection hash (40-char hex SHA-1)

## Request body

- UpdateCollectionRequest: Request body for updating collection details, or reparenting via `parentId`
  - `displayName` string
  - `description` string
  - `icon` string
  - `color` string
  - `parentId` string, nullable

## Response `200`

Collection updated successfully

- SuccessMessage
  - `message` string, required: Human-readable success message

## Other responses

- `404`: Collection not found

---

[API](https://skmtc.dev/numonic/apis/numonic-api.md) · [All operations](https://skmtc.dev/numonic/apis/numonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/numonic/apis/numonic-api/revisions/6c559bef1e35?raw)