Update bundle

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

Request Body schema: application/json

Object with bundle data.

sku

required

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

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

required

(two-letter (object or null)) or (five-letter (object or null))

Object with localizations for item’s name. Accepts value in one of two formats: two-letter lowercase language codes (e.g., en) or five-character language codes (e.g., en-US). While both formats are accepted as input, responses return two-letter lowercase language codes. When both options for the same language are provided (e.g., en and en-US), the last provided value is stored. You can find the full list of supported languages in the documentation.

One of:

Two-letter lowercase language codes.

en	string or null English
ar	string or null Arabic
bg	string or null Bulgarian
cn	string or null Chinese (Simplified)
cs	string or null Czech
de	string or null German
es	string or null Spanish (Spain)
fr	string or null French
he	string or null Hebrew
it	string or null Italian
ja	string or null Japanese
ko	string or null Korean
pl	string or null Polish
pt	string or null Portuguese
ro	string or null Romanian
ru	string or null Russian
th	string or null Thai
tr	string or null Turkish
tw	string or null Chinese (Traditional)
vi	string or null Vietnamese
km	string or null Khmer
id	string or null Indonesian
lo	string or null Lao
my	string or null Burmese
ph	string or null Filipino
ne	string or null Nepali

required

(two-letter (object or null)) or (five-letter (object or null))

Object with localizations for item’s description. Accepts value in one of two formats: two-letter lowercase language codes (e.g., en) or five-character locale codes (e.g., en-US). While both formats are accepted as input, responses return two-letter lowercase language codes. When both options for the same language are provided (e.g., en and en-US), the last provided value is stored. You can find the full list of supported languages in the documentation.

One of:

Two-letter lowercase language codes.

en	string or null English
ar	string or null Arabic
bg	string or null Bulgarian
cn	string or null Chinese (Simplified)
cs	string or null Czech
de	string or null German
es	string or null Spanish (Spain)
fr	string or null French
he	string or null Hebrew
it	string or null Italian
ja	string or null Japanese
ko	string or null Korean
pl	string or null Polish
pt	string or null Portuguese
ro	string or null Romanian
ru	string or null Russian
th	string or null Thai
tr	string or null Turkish
tw	string or null Chinese (Traditional)
vi	string or null Vietnamese
km	string or null Khmer
id	string or null Indonesian
lo	string or null Lao
my	string or null Burmese
ph	string or null Filipino
ne	string or null Nepali

groups

Array of strings

Default: []

Groups the item belongs to.

Note. The string value refers to group `external_id`.

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 contain only lowercase and uppercase 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

(two-letter (object or null)) or (five-letter (object or null))

Object with localizations for long description of item. Accepts value in one of two formats: two-letter lowercase language codes (e.g., en) or five-character locale codes (e.g., en-US). While both formats are accepted as input, responses return two-letter lowercase language codes. When both variants for the same language are provided (e.g., en and en-US), the last provided value is stored. You can find the full list of supported languages in the documentation.

Any of:

Two-letter lowercase language codes.

en	string or null English
ar	string or null Arabic
bg	string or null Bulgarian
cn	string or null Chinese (Simplified)
cs	string or null Czech
de	string or null German
es	string or null Spanish (Spain)
fr	string or null French
he	string or null Hebrew
it	string or null Italian
ja	string or null Japanese
ko	string or null Korean
pl	string or null Polish
pt	string or null Portuguese
ro	string or null Romanian
ru	string or null Russian
th	string or null Thai
tr	string or null Turkish
tw	string or null Chinese (Traditional)
vi	string or null Vietnamese
km	string or null Khmer
id	string or null Indonesian
lo	string or null Lao
my	string or null Burmese
ph	string or null Filipino
ne	string or null Nepali

image_url

string or null

Image URL.

Array of objects

Prices in real currencies.

Array

amount required	string^\d\.?\d$ Item price.
currency required	string Item price currency. Three-letter code per ISO 4217.
is_default required	boolean Default price is used to build a catalog if no price in the user's currency is specified.
is_enabled required	boolean The price is enabled.
country_iso	string or null Country where this price is available. Two-letter code per ISO 3166-1 alpha 2.

Array of objects or null

Array

amount required	integer
is_default required	boolean
is_enabled required	boolean
sku	string Unique item ID. The SKU may contain only lowercase and uppercase Latin alphanumeric characters, periods, dashes, and underscores.

bundle_type

string

Default: "standard"

Bundle type. Use standard to create a bundle with items and specify the SKUs of the items included in the bundle. Use partner_side_content to create an empty bundle and add items on your side using a webhook. This type is used only for Catalog personalization on partner side.

Enum: "standard" "partner_side_content"

Array of objects non-empty

Array (non-empty)

sku required	string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\-–.]*$ Unique item ID. The SKU may contain only lowercase and uppercase Latin alphanumeric characters, periods, dashes, and underscores.
quantity	integer >= 1 Default: 1 Quantity of the selected items in the bundle.

is_free

boolean

Default: false

If true, the item is free.

is_enabled

boolean

Default: true

If disabled, the item can't be found and purchased.

is_show_in_store

boolean

Default: false

Item is available for purchase.

Array of objects or null

Bundle's additional assets.

Array

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

order

integer

Default: 1

Bundle's order priority in the list.

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

Global item limitation.

object or null

Limit refresh period.

interval_type = daily (object) or interval_type = weekly (object) or interval_type = monthly (object)

One of:

Daily type of user limits refresh.

interval_type required	string Recurrent refresh period. Value: "daily"
time required	string((0[0-9]\|1[0-9]\|2[0-3]):00:00)(\+\|-)(0[0-9]\|1... Time of limit refresh in the desired time zone (rounding to hours).

Array of objects or null

Item sales period.

Array

date_from	string <date-time> Date when the specified item will be available for sale.
date_until	string or null <date-time> Date when the specified item will become unavailable for sale. Can be `null`.

custom_attributes

object <json> <= 500 characters

A JSON object containing item attributes and values. Attributes allow you to add more info to items like the player's required level to use the item. Attributes enrich your game's internal logic and are accessible through dedicated GET methods and webhooks.

Responses

204

Bundle 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": "com.xsolla.armour_chest_1",
"name": {"en": "Chest of armour",
"de": "Brustpanzer"
},
"is_enabled": true,
"is_free": true,
"order": 1,
"long_description": {"en": "Chest of armour for soldiers",
"de": "Brustpanzer für Soldaten"
},
"description": {"en": "Chest of armour for soldiers",
"de": "Brustpanzer für Soldaten"
},
"image_url": "https://picture.bundle-with-many-stuff.png",
"media_list": [{"type": "image",
"url": "https://test.com/image0"
},
{"type": "image",
"url": "https://test.com/image1"
}
],
"groups": ["chests"
],
"attributes": [{"external_id": "class",
"name": {"en": "Class"
},
"values": [{"external_id": "soldier",
"value": {"en": "Soldier"
}
},
{"external_id": "officer",
"value": {"en": "Officer"
}
}
]
}
],
"prices": [{"currency": "USD",
"amount": "9.99",
"is_default": true,
"is_enabled": true
},
{"currency": "EUR",
"amount": "9.99",
"is_default": false,
"is_enabled": true
}
],
"vc_prices": [ ],
"content": [{"sku": "com.xsolla.iron_gloves_1",
"quantity": 1
},
{"sku": "com.xsolla.iron_boots_1",
"quantity": 1
},
{"sku": "com.xsolla.iron_shield_1",
"quantity": 1
},
{"sku": "com.xsolla.iron_armour_1",
"quantity": 1
},
{"sku": "com.xsolla.iron_helmet_1",
"quantity": 1
}
],
"limits": {"per_user": null,
"per_item": null
},
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"custom_attributes": {"type": "lootbox",
"purchased": 0
}
}

Response samples

application/json

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