Update NFT item

Xsolla Developers

Conta de Distribuidor

Update NFT itemServer-sideAdmin

put/v2/project/{project_id}/admin/items/nft/sku/{item_sku}

Updates an NFT item.

SecuritybasicAuth

Request

path Parameters

project_id required	integer Project ID. You can find this parameter in your Publisher Account next to the name of the project. Example: 44056
item_sku required	string Item SKU. Example: booster_mega_1

Request Body schema: application/json

sku

string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$

Unique item ID. The SKU may only contain lowercase Latin alphanumeric characters, periods, dashes, and underscores.

object

Object with localizations for item's name. Two-letter lowercase language code.

en	string or null
ar	string or null
bg	string or null
cn	string or null
cs	string or null
de	string or null
es	string or null
fr	string or null
he	string or null
it	string or null
ja	string or null
ko	string or null
pl	string or null
pt	string or null
ro	string or null
ru	string or null
th	string or null
tr	string or null
tw	string or null
vi	string or null

object

Object with localizations for item's description. Two-letter lowercase language code.

en	string or null
ar	string or null
bg	string or null
cn	string or null
cs	string or null
de	string or null
es	string or null
fr	string or null
he	string or null
it	string or null
ja	string or null
ko	string or null
pl	string or null
pt	string or null
ro	string or null
ru	string or null
th	string or null
tr	string or null
tw	string or null
vi	string or null

object

Object with localizations for long description of item. Two-letter lowercase language code.

en	string or null
ar	string or null
bg	string or null
cn	string or null
cs	string or null
de	string or null
es	string or null
fr	string or null
he	string or null
it	string or null
ja	string or null
ko	string or null
pl	string or null
pt	string or null
ro	string or null
ru	string or null
th	string or null
tr	string or null
tw	string or null
vi	string or null

image_url

string

Image URL.

Array of objects

Item's additional assets such as screenshots, gameplay video and so on.

Array

type	string Type of media: `image`/`video`. Enum: "image" "video"
url	string Resource file.

Array of objects

Groups the item belongs to.

Array

external_id

string

Array of objects <= 20 items

List of attributes.

Attention. You can't specify more than 20 attributes for the item. Any attempts to exceed the limit result in an error.

Array (<= 20 items)

external_id

required

string [ 1 .. 255 ] characters ^[a-zA-Z0-9-_]+$

Unique attribute ID. The external_id may only contain lowercase Latin alphanumeric characters, dashes, and underscores.

required

Array of objects

Attention. You can't create more than 6 values for each attribute. Any attempts to exceed the limit result in an error.

Array

required

object

Default: {"en":"Strategy","de":"Strategie"}

Object with localizations of the value's name. Keys are specified in ISO 3166-1.

property name*

additional property

string

external_id

required

string [ 1 .. 255 ] characters ^[-_.\d\w]+$

Unique value ID for an attribute. The external_id may only contain lowercase Latin alphanumeric characters, dashes, and underscores.

object

Default: {"en":"Genre","de":"Genre"}

Object with localizations for attribute's name. Keys are specified in ISO 3166-1.

property name*

additional property

string

Array of objects

Array

amount required	number > 0 Amount.
currency required	string Item price currency. Three-letter code per ISO 4217. Check the documentation for detailed information about currencies supported by Xsolla.
country_iso	string Two-letter uppercase country code per ISO 3166-1 alpha-2. Check the documentation for detailed information about countries supported by Xsolla. Example: `country=US`
is_default	boolean Default: false
is_enabled	boolean Default: true

Array of objects

Array

amount required	integer
is_default required	boolean Default: false
is_enabled required	boolean Default: false The price is enabled.
sku	string Unique item ID. The SKU may only contain lowercase Latin alphanumeric characters, periods, dashes, and underscores.

is_enabled

boolean

is_deleted

boolean

is_show_in_store

boolean

is_free

boolean

Default: false

If true, the item is free.

order

integer

Defines arrangement order.

object

release_date required	string or null <date-time>
is_enabled required	boolean
description	string or null

Array of objects

Array

id	integer >= 1

object

Item limits.

per_user	integer or null Item limitation for a separate user.
per_item	integer or null Default: 1 Global item limitation. Always `1` for an `nft` item type.

is_minted

boolean

Default: false

blockchain

string [ 1 .. 20 ] characters

Default: null

Name of blockchain.

token_id

string [ 1 .. 78 ] characters ^\S*$

Default: null

Unique NFT token ID.

smart_contract_address

string [ 1 .. 78 ] characters ^\S*$

Default: null

Smart contract address.

cryptoaccount

string [ 1 .. 50 ] characters

Default: null

Name of crypto account.

Responses

204

NFT item was successfully updated.

401

Basic authentication not passed or wrong. Make sure you used basic authentication or correct credentials.

422

Invalid request.

Request samples

application/json

{"sku": "nft_item_1",
"name": {"en": "Sword",
"de": "Schwert"
},
"is_enabled": true,
"is_free": false,
"order": 1,
"description": {"en": "A sword is a bladed melee weapon intended for cutting or thrusting that is longer than a knife or dagger, consisting of a long blade attached to a hilt.",
"de": "Ein Schwert ist eine Nahkampfwaffe mit Klinge, die zum Schneiden oder Stechen bestimmt ist, länger als ein Messer oder Dolch ist und aus einer langen Klinge besteht, die an einem Griff befestigt ist."
},
"prices": [{"amount": 100,
"currency": "USD",
"is_enabled": true,
"is_default": true
},
{"amount": 200,
"currency": "CZK",
"country_iso": "CZ",
"is_enabled": false,
"is_default": true
}
],
"vc_prices": [ ],
"is_show_in_store": true,
"attributes": [{"external_id": "craft-materials",
"name": {"en": "Craft materials"
},
"values": [{"external_id": "steel",
"value": {"en-US": "5"
}
},
{"external_id": "leather",
"value": {"en-US": "1"
}
}
]
}
],
"limits": {"per_user": null,
"per_item": 1
},
"is_minted": true,
"blockchain": "blockchain_name",
"token_id": "115792089237316195423570985008687907853269984665640564039457584007913129639934",
"cryptoaccount": "cryptoaccount_name",
"smart_contract_address": "t1qskq33nssskznn0118oh355qjigmkpn8vekye6mctcgstrtrkibj2v7cf3tyk4ls05bdxr8nha02"
}

Response samples

application/json

{"statusCode": 401,
"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred"
}