---
title: "Refresh stacked metadata"
method: POST
path: "/v1/chains/{chain_name}/collections/{contract_address}/metadata/refresh-metadata"
tags: ["metadata"]
---

# Refresh stacked metadata

`POST /v1/chains/{chain_name}/collections/{contract_address}/metadata/refresh-metadata`

Refresh stacked metadata

## Path parameters

- `chain_name` string, required — The name of chain
- `contract_address` string, required — An Ethereum address

## Request body

- RefreshMetadataByIDRequest — Request body for refreshing metadata by id. Total size of this list should not exceed 228 KiB
  - `metadata` RefreshMetadataByID[], required
    - `name` string, nullable, required — The name of the NFT
    - `description` string, nullable, required — The description of the NFT
    - `image` string, nullable, required — The image url of the NFT
    - `external_url` string, nullable, required — The external link of the NFT
    - `animation_url` string, nullable, required — The animation url of the NFT
    - `youtube_url` string, nullable, required — The youtube link of the NFT
    - `attributes` NFTMetadataAttribute[], nullable, required — List of Metadata attributes
      - `display_type` 'number' | 'boost_percentage' | 'boost_number' | 'date', nullable — Display type for this attribute
      - `trait_type` string, required — The metadata trait type
      - `value` union, required — The metadata trait value
        - string
        - number
        - boolean
    - `metadata_id` string, uuid, required — Metadata id in UUIDv4 format

## Response `202`

Accepted

- MetadataRefreshRateLimitResult
  - `imx_refreshes_limit` string, required
  - `imx_refresh_limit_reset` string, required
  - `imx_remaining_refreshes` string, required
  - `retry_after` string, required

## Other responses

- `400` — Bad Request (400)
- `401` — Unauthorised Request (401)
- `403` — Forbidden Request (403)
- `404` — The specified resource was not found (404)
- `429` — Too Many Metadata refreshes (429)
- `500` — Internal Server Error (500)

---

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