Edit Item Offer – PlayerAuctions Help Center

PUT api/v1/offers/item

Update an existing item offer.

i. Request Example


  {
    "offerId": 71394134,
    "gameId": 3637,
    "title": "Offer Title Update",
    "offerDesc": "<p>Offer Description Update</p>",
    "offerDuration": 30,
    "agreeCheck": true,
    "price": 5,
    "serverId": 3638,
    "categoryId": 3638,
    "instruction": "this is an instruction.",
    "deliveryGuarantee": 3,
    "totalUnit": 2000,
    "minUnitPerOrder": 1,
    "discounts": [
      {
        "startPrice": 20,
        "discountRate": 1
      },
      {
        "startPrice": 60,
        "discountRate": 2
      },
      {
        "startPrice": 120,
        "discountRate": 5
      }
    ],
    "checkedDiscount": true,
    "rootItem": 290,
    "itemId": 1243,
    "otherItem": "",
    "itemsPerUnit": 20,
    "screenShot": "https://cdn-image.azureedge.net/title-image/liutest6/202606090117171717.png",
    "itemPath": "290|1243"
}

ii. Request Parameters

Body Parameters

Parameter	Type	Required	Description
offerId	int	Yes	Offer ID to update.
gameId	int	Yes	Game ID.
title	string	Yes	Offer title.
offerDesc	string	No	Offer description.
offerDuration	int	Yes	Offer duration in days.
agreeCheck	bool	Yes	Agreement check.
price	decimal	Yes	Offer price.
serverId	int	Yes	Server ID for the offer.
categoryId	int	Yes	Category ID for the offer.
instruction	string	Yes	Instruction for the offer.
deliveryGuarantee	int	Yes	Delivery guarantee for the offer.
totalUnit	int	Yes	Total units for the offer.
minUnitPerOrder	decimal	Yes	Minimum units per order.
totalUnit	int	Yes	Total units for the offer.
discounts	array	No	Discounts for the offer.
discounts[].startPrice	decimal	Yes	Discount start price for the first discount.
discounts[].discountRate	decimal	Yes	Discount rate for the first discount.
rootItem	int	Yes	Root item ID for the offer.
itemId	int	Yes	Item ID for the offer.
otherItem	string	Yes	Other item name for the offer.
itemsPerUnit	decimal	Yes	Items per unit for the offer.
screenShot	string	Yes	Screenshot URL for the offer.
itemPath	string	Yes	Item path for the offer. Format: rootItemId\|itemId.

iii. Response Example

Success Response

{
  "code": 10000,
  "message": "",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data":{
    "offerId": 71394135,
    "navigateURL": "https://www.playerauctions.com/lol-items/71394135i!offer-title-update/",
    "title": "Offer Title Update",
    "productType": "item",
    "gameName": "League of Legends",
    "productName": "Items",
    "screenShot": "https://cdn-image.azureedge.net/title-image/liutest6/202606090117171717.png",
    "recentLable": "LOL Items",
    "recentURL": "/offerCreation/?gameid=3637&type=item",
    "imageBlacklist": ""
  }
}

Response Parameters

Parameter	Type	Description
code	int	Response code. 10000 indicates success, other values indicate an error.
message	string	Response message. Contains error details on failure.
requestId	string	Unique identifier for the request, used for tracking.
data.offerId	int	Created offer ID.
data.navigateURL	string	URL to navigate to the offer page.
data.title	string	Offer title.
data.productType	string	Product type.
data.gameName	string	Game name.
data.productName	string	Product name.
data.screenShot	string	Screenshot URL.
data.recentLable	string	Recent label for the offer.
data.recentURL	string	URL to navigate to the offer page.
data.imageBlacklist	string	Image blacklist for the offer.

iv. Error Response Example

Error Response

{
  "code": 10002,
  "message": "Invalid parameter.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000"
}

Common Error Codes

Parameter	Type	Description
code	int	Error code. Common values: 10002 (Invalid parameter), 50001 (Internal server error).
message	string	Detailed error message explaining what went wrong.
requestId	string	Unique identifier for the request, used for tracking.