The POST route under the Item resource facilitates the creation of a new Item within a specified Metafuse project. By providing necessary parameters in the request body, users can precisely define the characteristics of the new Item. The required fields for this operation include projectId, tokenId, and visibility. Here’s an insight into the parameters:

  • projectId: A unique identifier for the project, ensuring the new Item is associated with the correct project.
  • tokenId: A numerical identifier starting from 1, providing a unique identity to the new Item within the project.
  • visibility: Dictates the visibility of the Item's image and metadata, accepting values of either PUBLIC or PRIVATE.

Additional parameters include:

  • image: A base64 encoded string that represents the image associated with the Item.
  • allowDuplicatesOverride: A boolean flag, defaulted to false, allowing the ability to create a duplicate of an item that may already exist.
  • traits: An array of objects defining various traits of the Item. Each object contains two properties:
    • value: The value of the trait, which can be either a string or a number.
    • trait_type: A string representing the type of trait.

Utilizing this route, developers can meticulously craft new Items, embedding necessary traits and attributes aligning with the project’s requirements. Each parameter plays a pivotal role in delineating the Item’s properties, ensuring a structured and coherent creation process within the Metafuse platform.

Click Try It! to start a request and see the response here!