Items

Grant an item to a player

Mints an item of a given item type to the specified player. If name, description, image, or attributes are not provided, the item will be granted with the default metadata configured on the item type. On-chain, granting an item means an NFT is minted from the collection associated with the item type to the wallet of the given player.

POST/v1/items

Header parameters

Body

application/json

The item to be created

itemTypeIdstring (uuid)

Unique identifier of the item

ownerPlayerIdstring (uuid)

The id of the player who owns the item

tokenIdinteger

The on-chain unique identifier of the item within its given collection. The token id of the item is displayed in the Mythical Marketplace.

Example: 1

metadataItemMetadata (object)

Response

200

Success

Body

application/json

idstring (uuid)

Unique identifier of the item

itemTypeIdstring (uuid)

Unique identifier of the item

ownerPlayerIdstring (uuid)

The id of the player who owns the item

tokenIdinteger

The on-chain unique identifier of the item within its given collection. The token id of the item is displayed in the Mythical Marketplace.

Example: 1

statestring

The current state of the item on chain

Example: "Issued"

metadataUrlstring

The location where the public metadata json is stored

Example: "http://url.com/1"

metadataItemMetadata (object)

Response

200

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "itemTypeId": "123e4567-e89b-12d3-a456-426614174000",
  "ownerPlayerId": "123e4567-e89b-12d3-a456-426614174000",
  "tokenId": 1,
  "state": "Issued",
  "metadataUrl": "http://url.com/1",
  "metadata": {
    "name": "text",
    "description": "text",
    "image": "text",
    "attributes": [
      {
        "type": "string",
        "value": "attrValue",
        "displayType": "number, boolean, string",
        "maxValue": 255
      }
    ]
  }
}

Search items

Retrieve a list of items. Supports filtering, sorting, and pagination.

POST/v1/items/search

Header parameters

Body

application/json

Defines the structure of a search request. Allows for filtering, sorting, and pagination of results when querying a list of items. The filter property specifies the criteria used to filter the data, sort defines the order in which the results should be returned, and pagination controls the number of results returned and the starting point within the dataset.

filterobject

sortobject

paginationobject

Response

200

Success

Body

application/json

idstring (uuid)

Unique identifier of the item

itemTypeIdstring (uuid)

Unique identifier of the item

ownerPlayerIdstring (uuid)

The id of the player who owns the item

tokenIdinteger

The on-chain unique identifier of the item within its given collection. The token id of the item is displayed in the Mythical Marketplace.

Example: 1

statestring

The current state of the item on chain

Example: "Issued"

metadataUrlstring

The location where the public metadata json is stored

Example: "http://url.com/1"

metadataItemMetadata (object)

Response

200

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "itemTypeId": "123e4567-e89b-12d3-a456-426614174000",
    "ownerPlayerId": "123e4567-e89b-12d3-a456-426614174000",
    "tokenId": 1,
    "state": "Issued",
    "metadataUrl": "http://url.com/1",
    "metadata": {
      "name": "text",
      "description": "text",
      "image": "text",
      "attributes": [
        {
          "type": "string",
          "value": "attrValue",
          "displayType": "number, boolean, string",
          "maxValue": 255
        }
      ]
    }
  }
]

Get an item

Retrieve a single item by id.

GET/v1/items/{itemId}

Path parameters

itemId*string

Header parameters

Response

200

Success

Body

application/json

idstring (uuid)

Unique identifier of the item

itemTypeIdstring (uuid)

Unique identifier of the item

ownerPlayerIdstring (uuid)

The id of the player who owns the item

tokenIdinteger

The on-chain unique identifier of the item within its given collection. The token id of the item is displayed in the Mythical Marketplace.

Example: 1

statestring

The current state of the item on chain

Example: "Issued"

metadataUrlstring

The location where the public metadata json is stored

Example: "http://url.com/1"

metadataItemMetadata (object)

Response

200

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "itemTypeId": "123e4567-e89b-12d3-a456-426614174000",
  "ownerPlayerId": "123e4567-e89b-12d3-a456-426614174000",
  "tokenId": 1,
  "state": "Issued",
  "metadataUrl": "http://url.com/1",
  "metadata": {
    "name": "text",
    "description": "text",
    "image": "text",
    "attributes": [
      {
        "type": "string",
        "value": "attrValue",
        "displayType": "number, boolean, string",
        "maxValue": 255
      }
    ]
  }
}

Update an item

Update an item

PUT/v1/items/{itemId}

Path parameters

itemId*string

Header parameters

Body

application/json

Updates to be made to the item

metadataItemMetadata (object)

Response

200

Success

Body

application/json

idstring (uuid)

Unique identifier of the item

itemTypeIdstring (uuid)

Unique identifier of the item

ownerPlayerIdstring (uuid)

The id of the player who owns the item

tokenIdinteger

The on-chain unique identifier of the item within its given collection. The token id of the item is displayed in the Mythical Marketplace.

Example: 1

statestring

The current state of the item on chain

Example: "Issued"

metadataUrlstring

The location where the public metadata json is stored

Example: "http://url.com/1"

metadataItemMetadata (object)

Response

200

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "itemTypeId": "123e4567-e89b-12d3-a456-426614174000",
  "ownerPlayerId": "123e4567-e89b-12d3-a456-426614174000",
  "tokenId": 1,
  "state": "Issued",
  "metadataUrl": "http://url.com/1",
  "metadata": {
    "name": "text",
    "description": "text",
    "image": "text",
    "attributes": [
      {
        "type": "string",
        "value": "attrValue",
        "displayType": "number, boolean, string",
        "maxValue": 255
      }
    ]
  }
}

Transfer an item from one player to another

On-chain, this will transfer the item between the wallets of the provided players.

POST/v1/items/{itemId}/transfer

Path parameters

itemId*string (uuid)

The id of the item to transfer

Header parameters

Body

application/json

The ids of the players to transfer the item between

fromPlayerIdstring (uuid)

Player from which the item will be transferred

toPlayerIdstring (uuid)

Player to which the item will be transferred

Response

200

Success

Body

application/json

idstring (uuid)

Unique identifier of the item

itemTypeIdstring (uuid)

Unique identifier of the item

ownerPlayerIdstring (uuid)

The id of the player who owns the item

tokenIdinteger

The on-chain unique identifier of the item within its given collection. The token id of the item is displayed in the Mythical Marketplace.

Example: 1

statestring

The current state of the item on chain

Example: "Issued"

metadataUrlstring

The location where the public metadata json is stored

Example: "http://url.com/1"

metadataItemMetadata (object)

Response

200

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "itemTypeId": "123e4567-e89b-12d3-a456-426614174000",
  "ownerPlayerId": "123e4567-e89b-12d3-a456-426614174000",
  "tokenId": 1,
  "state": "Issued",
  "metadataUrl": "http://url.com/1",
  "metadata": {
    "name": "text",
    "description": "text",
    "image": "text",
    "attributes": [
      {
        "type": "string",
        "value": "attrValue",
        "displayType": "number, boolean, string",
        "maxValue": 255
      }
    ]
  }
}

Burn an item

On-chain, this will irreversably transfer the item to the zero address (0x000...), effectively destroying the item.

POST/v1/items/{itemId}/burn

Path parameters

itemId*string

Header parameters

Response

200

Success

Body

application/json

idstring (uuid)

Unique identifier of the item

itemTypeIdstring (uuid)

Unique identifier of the item

ownerPlayerIdstring (uuid)

The id of the player who owns the item

tokenIdinteger

The on-chain unique identifier of the item within its given collection. The token id of the item is displayed in the Mythical Marketplace.

Example: 1

statestring

The current state of the item on chain

Example: "Issued"

metadataUrlstring

The location where the public metadata json is stored

Example: "http://url.com/1"

metadataItemMetadata (object)

Response

200

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "itemTypeId": "123e4567-e89b-12d3-a456-426614174000",
  "ownerPlayerId": "123e4567-e89b-12d3-a456-426614174000",
  "tokenId": 1,
  "state": "Issued",
  "metadataUrl": "http://url.com/1",
  "metadata": {
    "name": "text",
    "description": "text",
    "image": "text",
    "attributes": [
      {
        "type": "string",
        "value": "attrValue",
        "displayType": "number, boolean, string",
        "maxValue": 255
      }
    ]
  }
}