---
title: "Update a profile shelf"
method: PATCH
path: "/api/v2/profile/shelves/{shelf_id}"
tags: ["Account Endpoints"]
---

# Update a profile shelf

`PATCH /api/v2/profile/shelves/{shelf_id}`

Update shelf fields and optionally item descriptions. Shelf field updates are applied first; if a later item description update fails, earlier changes are not rolled back.

## Path parameters

- `shelf_id` string, required

## Request body

- UpdateProfileShelfRequest — Request body for updating a profile shelf
  - `title` string — Shelf title
  - `description` string — Shelf description
  - `items` ProfileShelfItemUpdateRequest[]
    - `item` ProfileShelfItemRequest, required — A shelf item identifier
      - `token_id` string, required — Item token ID
      - `chain` string, required — Blockchain chain slug
      - `contract_address` string, required — Contract address
    - `description` string — Optional item description
  - `icon` string — Shelf icon
  - `view` string — Shelf view
  - `single_item_shelf_side` string — Single-item shelf side

## Response `200`

Shelf updated successfully

- ProfileShelfResponse — Profile shelf
  - `id` string, required
  - `account_address` string
  - `title` string, required
  - `description` string
  - `display_order` integer, required
  - `items` ProfileShelfItemIdentifierResponse[], required
    - `chain` string, required
    - `contract_address` string, required
    - `token_id` string, required
  - `icon` string
  - `view` string
  - `single_item_shelf_side` string
  - `shelf_item_metadata` object, required

## Other responses

- `400` — For error reasons, review the response data.
- `401` — Invalid or missing API key
- `403` — Wallet token lacks permission for this request
- `404` — Resource not found
- `409` — Conflict
- `500` — Internal Server Error

---

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