---
title: "Update collection metadata"
method: PATCH
path: "/api/v2/collections/{slug}/metadata"
tags: ["Collection Endpoints"]
---

# Update collection metadata

`PATCH /api/v2/collections/{slug}/metadata`

Update collection about, hero, overview, and logo image metadata.

## Path parameters

- `slug` string, required

## Request body

- UpdateCollectionMetadataRequest — Request body for updating collection metadata
  - `about` AboutMetadataRequest — Collection about content
    - `preview_media` MediaInputRequest[] — Preview media
      - `image` ImageMediaRequest — An image media input
        - `token` string, required — Image token
      - `video` VideoMediaRequest — A video media input
        - `token` string, required — Video token
        - `enable_static_video` boolean — Enable static video
    - `sections` AboutSectionRequest[] — About sections
      - `id` string — Section ID
      - `title` string, required — Section title
      - `description` string, required — Section description
      - `media` MediaInputRequest[] — Section media
        - `image` ImageMediaRequest — An image media input
          - `token` string, required — Image token
        - `video` VideoMediaRequest — A video media input
          - `token` string, required — Video token
          - `enable_static_video` boolean — Enable static video
  - `hero` HeroMetadataRequest — Collection hero content
    - `desktop_hero_media` MediaInputRequest — A generic media input
      - `image` ImageMediaRequest — An image media input
        - `token` string, required — Image token
      - `video` VideoMediaRequest — A video media input
        - `token` string, required — Video token
        - `enable_static_video` boolean — Enable static video
    - `mobile_hero_media` MediaInputRequest — A generic media input
      - `image` ImageMediaRequest — An image media input
        - `token` string, required — Image token
      - `video` VideoMediaRequest — A video media input
        - `token` string, required — Video token
        - `enable_static_video` boolean — Enable static video
  - `overview` OverviewMetadataRequest — Collection overview content
    - `modules` OverviewModuleRequest, required — Overview modules
      - `narrative` NarrativeModuleRequest[] — Narrative modules
        - `id` string — Module ID
        - `index` integer, required — Module index
        - `title` string, required — Module title
        - `description` string, required — Module description
        - `media` MediaInputRequest[] — Module media
          - `image` ImageMediaRequest — An image media input
            - `token` string, required — Image token
          - `video` VideoMediaRequest — A video media input
            - `token` string, required — Video token
            - `enable_static_video` boolean — Enable static video
        - `horizontal_text_position` string — Horizontal text position
        - `vertical_text_position` string — Vertical text position
        - `desktop_background_media` MediaInputRequest — A generic media input
          - `image` ImageMediaRequest — An image media input
            - `token` string, required — Image token
          - `video` VideoMediaRequest — A video media input
            - `token` string, required — Video token
            - `enable_static_video` boolean — Enable static video
        - `mobile_background_media` MediaInputRequest — A generic media input
          - `image` ImageMediaRequest — An image media input
            - `token` string, required — Image token
          - `video` VideoMediaRequest — A video media input
            - `token` string, required — Video token
            - `enable_static_video` boolean — Enable static video
        - `variant` string — Module variant
        - `background_image` ImageMediaRequest — An image media input
          - `token` string, required — Image token
        - `background_media` MediaInputRequest — A generic media input
          - `image` ImageMediaRequest — An image media input
            - `token` string, required — Image token
          - `video` VideoMediaRequest — A video media input
            - `token` string, required — Video token
            - `enable_static_video` boolean — Enable static video
      - `content_block` ContentBlockModuleRequest[] — Content block modules
        - `index` integer, required — Module index
        - `id` string — Module ID
        - `title` string — Module title
        - `description` string — Module description
        - `sections` ContentBlockSectionRequest[] — Module sections
          - `id` string — Section ID
          - `title` string — Section title
          - `description` string — Section description
          - `external_link` LinkRequest — A link input
            - `href` string, required — Link URL
            - `label` string, required — Link label
          - `media` MediaInputRequest — A generic media input
            - `image` ImageMediaRequest — An image media input
              - …
            - `video` VideoMediaRequest — A video media input
              - …
          - `module_type` string, required — Section module type
          - `date` string — Section date
          - `collection_slug` string — Collection slug
          - `token_id` string — Token ID
      - `team` TeamBlockModuleRequest[] — Team modules
        - `index` integer, required — Module index
        - `hidden` boolean — Whether the module is hidden
        - `title` string — Module title
        - `description` string — Module description
        - `sections` TeamSectionRequest[] — Module sections
          - `id` string — Section ID
          - `name` string, required — Section name
          - `title` string, required — Section title
          - `bio` string, required — Section bio
          - `website_url` string — Website URL
          - `twitter_url` string — Twitter URL
          - `instagram_url` string — Instagram URL
          - `media` MediaInputRequest[] — Section media
            - `image` ImageMediaRequest — An image media input
              - …
            - `video` VideoMediaRequest — A video media input
              - …
      - `faq` FaqBlockModuleRequest[] — FAQ modules
        - `index` integer, required — Module index
        - `hidden` boolean — Whether the module is hidden
        - `title` string — Module title
        - `description` string — Module description
        - `sections` FaqSectionRequest[] — Module sections
          - `id` string — Section ID
          - `question` string, required — Question
          - `answer` string, required — Answer
  - `logo_image_token` string — Collection logo image token

## Response `200`

Collection metadata updated successfully

## Other responses

- `400` — For error reasons, review the response data.
- `401` — Invalid or missing API key
- `403` — Forbidden
- `404` — Resource not found
- `409` — Conflict
- `500` — Internal server error. Please open a support ticket so OpenSea can investigate.

---

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