> ## Documentation Index > Fetch the complete documentation index at: https://docs.immutable.com/llms.txt > Use this file to discover all available pages before exploring further. # Refresh NFT metadata > Refresh NFT metadata ## OpenAPI ````yaml https://imx-openapiv3-mr-sandbox.s3.us-east-2.amazonaws.com/openapi.json post /v1/chains/{chain_name}/collections/{contract_address}/nfts/refresh-metadata openapi: 3.0.3 info: title: Immutable zkEVM API version: 1.0.0 description: Immutable Multi Rollup API contact: name: Immutable API Support email: support@immutable.com url: https://support.immutable.com servers: - url: https://api.sandbox.immutable.com security: [] tags: - name: activities description: Activities Endpoints x-displayName: activities - name: chains description: Chains Endpoints x-displayName: chains - name: collections description: Collections Endpoints x-displayName: collections - name: nfts description: NFTs Endpoints x-displayName: nfts - name: nft owners description: NFT Owner Endpoints x-displayName: nft owners - name: metadata description: NFT Metadata Endpoints x-displayName: metadata - name: tokens description: ERC20 Token Endpoints x-displayName: tokens - name: demopage description: Temporary HTML endpoint for demo purposes x-displayName: demopage - name: verification x-displayName: verification - name: operatorallowlist x-displayName: operatorallowlist - name: crafting x-displayName: crafting - name: listings description: Listings Endpoints x-displayName: listings - name: orders x-displayName: orders - name: passport description: Passport operations x-displayName: passport - name: gamefi description: team gamefi x-displayName: gamefi - name: health x-displayName: health - name: passport profile description: Passport Profile endpoints x-displayName: passport profile - name: feed-items x-displayName: feed-items - name: assets x-displayName: assets - name: guardian description: Guardian endpoints x-displayName: guardian - name: pricing description: Pricing Endpoints x-displayName: pricing - name: metadata-search x-displayName: metadata-search paths: /v1/chains/{chain_name}/collections/{contract_address}/nfts/refresh-metadata: post: tags: - metadata summary: Refresh NFT metadata description: Refresh NFT metadata operationId: RefreshNFTMetadataByTokenID parameters: - name: contract_address in: path description: The address of contract required: true schema: type: string example: '0x8a90cab2b38dba80c64b7734e58ee1db38b8992e' - name: chain_name description: The name of chain in: path required: true schema: $ref: '#/components/schemas/ChainName' requestBody: description: the request body required: true content: application/json: schema: $ref: '#/components/schemas/RefreshNFTMetadataByTokenIDRequest' responses: '202': description: Accepted headers: imx-refreshes-limit: $ref: '#/components/headers/MetadataRefreshLimit' imx-refresh-limit-reset: $ref: '#/components/headers/MetadataRefreshLimitReset' imx-remaining-refreshes: $ref: '#/components/headers/MetadataRefreshLimitRemaining' retry-after: $ref: '#/components/headers/MetadataRefreshRetryAfter' content: application/json: schema: $ref: '#/components/schemas/MetadataRefreshRateLimitResult' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/UnauthorisedRequest' '403': $ref: '#/components/responses/ForbiddenRequest' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/TooManyMetadataRefreshes' '500': $ref: '#/components/responses/InternalServerError' security: - ImmutableApiKey: - refresh:metadata components: schemas: ChainName: type: string description: The name of chain example: imtbl-zkevm-testnet RefreshNFTMetadataByTokenIDRequest: type: object properties: nft_metadata: type: array description: >- List of nft metadata to be refreshed. Total size of the list should not exceed 228 KiB maxItems: 250 minItems: 1 items: $ref: '#/components/schemas/RefreshMetadataByTokenID' required: - nft_metadata MetadataRefreshRateLimitResult: type: object properties: imx_refreshes_limit: type: string imx_refresh_limit_reset: type: string imx_remaining_refreshes: type: string retry_after: type: string required: - imx_refreshes_limit - imx_refresh_limit_reset - imx_remaining_refreshes - retry_after RefreshMetadataByTokenID: allOf: - $ref: '#/components/schemas/RefreshableNFTAttributes' - type: object properties: token_id: description: An `uint256` token id as string type: string example: '1' required: - token_id APIError400: allOf: - $ref: '#/components/schemas/BasicAPIError' - type: object properties: code: type: string description: Error Code enum: - VALIDATION_ERROR example: VALIDATION_ERROR details: type: object nullable: true description: Additional details to help resolve the error required: - code - details APIError401: allOf: - $ref: '#/components/schemas/BasicAPIError' - type: object properties: code: type: string description: Error Code enum: - UNAUTHORISED_REQUEST example: UNAUTHORISED_REQUEST details: type: object nullable: true description: Additional details to help resolve the error required: - code - details APIError403: allOf: - $ref: '#/components/schemas/BasicAPIError' - type: object properties: code: type: string description: Error Code enum: - AUTHENTICATION_ERROR example: AUTHENTICATION_ERROR details: type: object nullable: true description: Additional details to help resolve the error required: - code - details APIError404: allOf: - $ref: '#/components/schemas/BasicAPIError' - type: object properties: code: type: string description: Error Code enum: - RESOURCE_NOT_FOUND example: RESOURCE_NOT_FOUND details: type: object nullable: true description: Additional details to help resolve the error required: - code - details APIError429: allOf: - $ref: '#/components/schemas/BasicAPIError' - type: object properties: code: type: string description: Error Code enum: - TOO_MANY_REQUESTS_ERROR example: TOO_MANY_REQUESTS_ERROR details: type: object nullable: true description: Additional details to help resolve the error required: - code - details APIError500: allOf: - $ref: '#/components/schemas/BasicAPIError' - type: object properties: code: type: string description: Error Code enum: - INTERNAL_SERVER_ERROR example: INTERNAL_SERVER_ERROR details: type: object nullable: true description: Additional details to help resolve the error required: - code - details RefreshableNFTAttributes: allOf: - $ref: '#/components/schemas/NFTMetadataRequest' required: - name - description - image - external_url - animation_url - youtube_url - attributes BasicAPIError: type: object properties: message: type: string description: Error Message example: all fields must be provided link: type: string description: Link to IMX documentation that can help resolve this error example: https://docs.x.immutable.com/reference/#/ trace_id: type: string description: Trace ID of the initial request example: e47634b79a5cd6894ddc9639ec4aad26 required: - message - link - trace_id NFTMetadataRequest: type: object description: The NFT metadata. Total size of this object should not exceed 16 KiB properties: name: type: string nullable: true example: Sword description: The name of the NFT description: type: string nullable: true example: '2022-08-16T17:43:26.991388Z' description: The description of the NFT image: type: string nullable: true description: The image url of the NFT example: https://some-url external_url: type: string nullable: true description: The external link of the NFT example: https://some-url animation_url: type: string nullable: true description: The animation url of the NFT example: https://some-url youtube_url: type: string nullable: true description: The youtube link of the NFT example: https://some-url attributes: type: array description: List of Metadata attributes nullable: true items: $ref: '#/components/schemas/NFTMetadataAttribute' NFTMetadataAttribute: type: object properties: display_type: description: Display type for this attribute type: string nullable: true enum: - number - boost_percentage - boost_number - date example: number trait_type: description: The metadata trait type type: string example: Aqua Power value: oneOf: - type: string - type: number - type: boolean description: The metadata trait value example: Happy required: - trait_type - value headers: MetadataRefreshLimit: description: >- The refresh request limit available to the project for each one-hour window. schema: type: string MetadataRefreshLimitReset: description: The expiry date of the current one-hour window. schema: type: string MetadataRefreshLimitRemaining: description: The number of refresh requests remaining in the current window. schema: type: string MetadataRefreshRetryAfter: description: The number of seconds until the next refresh request can be made. schema: type: string responses: BadRequest: description: Bad Request (400) content: application/json: schema: $ref: '#/components/schemas/APIError400' UnauthorisedRequest: description: Unauthorised Request (401) content: application/json: schema: $ref: '#/components/schemas/APIError401' ForbiddenRequest: description: Forbidden Request (403) content: application/json: schema: $ref: '#/components/schemas/APIError403' NotFound: description: The specified resource was not found (404) content: application/json: schema: $ref: '#/components/schemas/APIError404' TooManyMetadataRefreshes: description: Too Many Metadata refreshes (429) content: application/json: schema: $ref: '#/components/schemas/APIError429' headers: imx-refreshes-limit: $ref: '#/components/headers/MetadataRefreshLimit' imx-refresh-limit-reset: $ref: '#/components/headers/MetadataRefreshLimitReset' imx-remaining-refreshes: $ref: '#/components/headers/MetadataRefreshLimitRemaining' Retry-After: $ref: '#/components/headers/MetadataRefreshRetryAfter' InternalServerError: description: Internal Server Error (500) content: application/json: schema: $ref: '#/components/schemas/APIError500' securitySchemes: ImmutableApiKey: x-go-name: ImmutableApiKey type: apiKey in: header name: x-immutable-api-key ````