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

# Refresh NFT metadata

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

Refresh NFT metadata

## Path parameters

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

## Request body

- RefreshNFTMetadataByTokenIDRequest
  - `nft_metadata` RefreshMetadataByTokenID[], required — List of nft metadata to be refreshed. Total size of the list should not exceed 228 KiB
    - `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
    - `token_id` string, required — An `uint256` token id as string

## 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)