---
updatedAt: 2025-09-22T22:25:33.000Z
agentTools:
  projectIndex: https://dev.tensor.trade/llms.txt
---

# Refresh Mint Metadata

Refreshes NFT Metadata. There is a 1 hour cooldown

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "components": {
    "schemas": {
      "Attribute": {
        "properties": {
          "trait_type": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "trait_type",
          "value"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "_36_Enums.TokenStandard": {
        "type": "string",
        "enum": [
          "NON_FUNGIBLE",
          "FUNGIBLE_ASSET",
          "FUNGIBLE",
          "NON_FUNGIBLE_EDITION",
          "PROGRAMMABLE_NON_FUNGIBLE",
          "PROGRAMMABLE_NON_FUNGIBLE_EDITION"
        ]
      },
      "MetadataFile": {
        "properties": {
          "type": {
            "type": "string",
            "nullable": true
          },
          "uri": {
            "type": "string",
            "nullable": true
          }
        },
        "type": "object",
        "additionalProperties": false
      },
      "Currency": {
        "enum": [
          "SOL_LAMPORT",
          "ETH_WEI"
        ],
        "type": "string"
      },
      "Decimal": {
        "type": "string"
      },
      "TLastSale": {
        "properties": {
          "priceUnit": {
            "$ref": "#/components/schemas/Currency"
          },
          "price": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Decimal"
              },
              {
                "type": "string"
              },
              {
                "type": "number",
                "format": "double"
              }
            ]
          },
          "txAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "string"
              }
            ]
          }
        },
        "required": [
          "priceUnit",
          "price",
          "txAt"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "StakeDetails": {
        "properties": {
          "stakedAt": {
            "type": "string",
            "format": "date-time"
          },
          "activatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "stakedByOwner": {
            "type": "string"
          }
        },
        "required": [
          "stakedAt",
          "activatedAt",
          "stakedByOwner"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "InscriptionSpl20Data": {
        "properties": {
          "p": {
            "type": "string"
          },
          "tick": {
            "type": "string"
          },
          "amt": {
            "$ref": "#/components/schemas/Decimal"
          }
        },
        "required": [
          "p",
          "tick",
          "amt"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "InscriptionData": {
        "properties": {
          "inscription": {
            "type": "string",
            "nullable": true
          },
          "inscriptionData": {
            "type": "string"
          },
          "immutable": {
            "type": "boolean"
          },
          "order": {
            "$ref": "#/components/schemas/Decimal"
          },
          "spl20": {
            "allOf": [
              {
                "$ref": "#/components/schemas/InscriptionSpl20Data"
              }
            ],
            "nullable": true
          }
        },
        "required": [
          "inscription",
          "inscriptionData",
          "immutable",
          "order"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "_36_Enums.TokenProgram": {
        "type": "string",
        "enum": [
          "SPL_TOKEN",
          "SPL_TOKEN_2022",
          "MPL_CORE",
          "BUBBLEGUM"
        ]
      },
      "_36_Enums.MetadataProgram": {
        "type": "string",
        "enum": [
          "SPL_TOKEN_2022",
          "MPL_CORE",
          "TOKEN_METADATA"
        ]
      },
      "MintWithColl": {
        "properties": {
          "onchainId": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "tokenStandard": {
            "allOf": [
              {
                "$ref": "#/components/schemas/_36_Enums.TokenStandard"
              }
            ],
            "nullable": true
          },
          "tokenEdition": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "imageUri": {
            "type": "string",
            "nullable": true
          },
          "metadataUri": {
            "type": "string",
            "nullable": true
          },
          "metadataFetchedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "files": {
            "items": {
              "$ref": "#/components/schemas/MetadataFile"
            },
            "type": "array",
            "nullable": true
          },
          "sellRoyaltyFeeBPS": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "attributes": {
            "items": {
              "$ref": "#/components/schemas/Attribute"
            },
            "type": "array",
            "nullable": true
          },
          "animationUri": {
            "type": "string",
            "nullable": true
          },
          "rarityRankTT": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "rarityRankTTStat": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "rarityRankTTCustom": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "rarityRankHR": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "rarityRankTN": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "rarityRankHrtt": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "rarityRankStat": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "rarityRankTeam": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "rarityRankTn": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "lastSale": {
            "allOf": [
              {
                "$ref": "#/components/schemas/TLastSale"
              }
            ],
            "nullable": true
          },
          "accState": {
            "type": "string",
            "nullable": true
          },
          "hidden": {
            "type": "boolean"
          },
          "compressed": {
            "type": "boolean"
          },
          "verifiedCollection": {
            "type": "string",
            "nullable": true
          },
          "owner": {
            "type": "string",
            "nullable": true
          },
          "staked": {
            "allOf": [
              {
                "$ref": "#/components/schemas/StakeDetails"
              }
            ],
            "nullable": true
          },
          "inscription": {
            "allOf": [
              {
                "$ref": "#/components/schemas/InscriptionData"
              }
            ],
            "nullable": true
          },
          "tokenProgram": {
            "allOf": [
              {
                "$ref": "#/components/schemas/_36_Enums.TokenProgram"
              }
            ],
            "nullable": true
          },
          "metadataProgram": {
            "allOf": [
              {
                "$ref": "#/components/schemas/_36_Enums.MetadataProgram"
              }
            ],
            "nullable": true
          },
          "transferHookProgram": {
            "type": "string",
            "nullable": true
          },
          "listingNormalizedPrice": {
            "type": "string",
            "nullable": true
          },
          "hybridAmount": {
            "type": "string",
            "nullable": true
          },
          "collId": {
            "type": "string"
          },
          "collName": {
            "type": "string"
          },
          "slugDisplay": {
            "type": "string",
            "nullable": true
          },
          "numMints": {
            "type": "number",
            "format": "double",
            "nullable": true
          }
        },
        "required": [
          "onchainId",
          "hidden",
          "compressed",
          "collId",
          "collName",
          "slug"
        ],
        "type": "object",
        "additionalProperties": false,
        "deprecated": true
      }
    },
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "name": "x-tensor-api-key",
        "in": "header"
      }
    }
  },
  "info": {
    "title": "Refresh API",
    "version": "1.0.0",
    "contact": {}
  },
  "paths": {
    "/trigger/refresh_metadata": {
      "post": {
        "operationId": "RefreshMetadata",
        "responses": {
          "200": {
            "description": "Ok",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/MintWithColl"
                    }
                  ],
                  "nullable": true
                }
              }
            }
          },
          "400": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "message": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "message"
                  ],
                  "type": "object"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error"
          }
        },
        "description": "Refreshes NFT Metadata. There is a 1 hour cooldown",
        "summary": "Refresh Mint Metadata",
        "security": [
          {
            "api_key": []
          }
        ],
        "parameters": [
          {
            "description": "The mint addresses to fetch",
            "in": "query",
            "name": "mint",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": [
          "Update Data"
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://api.mainnet.tensordev.io/api/v1"
    }
  ]
}
```