Skip to main content
PATCH
/
v2
/
item-offers
/
{itemOffer}
Update an item offer
curl --request PATCH \
  --url https://api.gameboost.com/v2/item-offers/{itemOffer} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "game_id": 123,
  "game": "<string>",
  "external_id": "<string>",
  "title": "<string>",
  "slug": "<string>",
  "description": "<string>",
  "price": 9.99,
  "stock": 50,
  "min_quantity": 1,
  "delivery_instructions": "<string>",
  "excluded_delivery_fields": [],
  "delivery_time": {
    "duration": 24,
    "unit": "hours"
  },
  "image_urls": [
    "https://example.com/item1.jpg"
  ],
  "item_data": {
    "rarity": "legendary",
    "type": "skin"
  }
}
'
{
  "data": {
    "id": 123,
    "external_id": "<string>",
    "game": {
      "id": 123,
      "name": "<string>",
      "slug": "<string>"
    },
    "title": "<string>",
    "slug": "<string>",
    "description": "<string>",
    "parameters": {},
    "delivery_time": {
      "duration": 123,
      "format": "<string>",
      "format_long": "<string>",
      "seconds": 123
    },
    "delivery_instructions": "<string>",
    "excluded_delivery_fields": [],
    "delivery_method_data": {},
    "stock": 123,
    "min_quantity": 123,
    "price_eur": "<string>",
    "price_usd": "<string>",
    "views": 123,
    "image_urls": [
      "<string>"
    ],
    "created_at": 123,
    "updated_at": 123,
    "listed_at": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.gameboost.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
itemOffer
string
required

The ID of the item offer. Can be retrieved from the list of item offers.

Body

application/json

Update item offer - all fields are optional, only provide fields you want to update

​
game_id
integer

Unique identifier for the game (required if game slug not provided)

​
game
string

Slug of the game (required if game_id not provided)

​
external_id
string

External identifier for the item offer, used to map to your own system

Maximum string length: 255
​
title
string

Display title for the item offer

Maximum string length: 255
​
slug
string

Custom URL-friendly identifier (auto-generated if not provided)

Maximum string length: 255
​
description
string

Detailed description of the items and what is included

Maximum string length: 2048
​
price
number

Price per unit in EUR currency, up to 2 decimal places

Required range: x >= 0.01
Example:

9.99

​
stock
integer

Available quantity of items in stock

Required range: 0 <= x <= 1000000000
Example:

50

​
min_quantity
integer
default:1

Minimum quantity that can be purchased in a single order

Required range: 1 <= x <= 1000000000
Example:

1

​
delivery_instructions
string

Special instructions for item delivery, provided to buyer after purchase

​
delivery_method
enum<string> | null

Optional delivery method. If null, no item precheckout delivery form is shown.

Available options:
none,
username,
login,
trade,
auction,
gift,
redeem,
mail
​
excluded_delivery_fields
enum<string>[] | null

Optional delivery fields disabled by the seller. Required fields for the selected method cannot be excluded.

Available options:
username,
server,
login,
password,
platform,
region
​
delivery_time
object

Expected delivery time object

Example:
{ "duration": 24, "unit": "hours" }
​
image_urls
string[]

Array of image URLs showcasing the items. Only one image is required. Recommended: transparent square images for best display. Note: Imgur URLs are not supported

Minimum array length: 1

Image URL

Example:
["https://example.com/item1.jpg"]
​
item_data
object

Specifics available via the template endpoint. Game-specific item attributes such as rarity, type, or category

Example:
{ "rarity": "legendary", "type": "skin" }

Response

A single item offer

​
data
object

Item offer object representing in-game items for sale