/Items/{itemID} PUT

Allows you to edit an item for sale.

URL
/Items/{itemID}
Verb
Put

Headers

Header Data Type Valid Values Required Description
Content-Type string application/json YES The format your data will be sent to our site.
X-DevKey string string YES The devkey assigned to the developer.
X-AccessToken string string YES The token acquired from a POST to Users/AccessToken.

Input

NOTE: Variables to place in the body of the request.

Parameter Data Type Valid Values Description
AutoAcceptPrice decimal positive # The minimum price for an offer to be automatically accepted.
AutoRejectPrice decimal positive # The maximum price for an offer to be automatically rejected
BuyNowPrice decimal positive # Optional (No change made to this value if excluded from JSON data). The price you will sell the item for immediately. If used, the price must be greater than or equal to the Starting Bid and Reserve Price.
CanOffer boolean true/false Specifies whether the item is enabled for offer functionality. If true, you must also send AutoAcceptPrice and AutoRejectPrice. If false and the item has open offers, you must also send CancelOpenOffers to confirm the cancellation of the offers.
CancelOpenOffers boolean true/false If CanOffer is set to false and the item has open offers, you must send this flag to confirm that any pending open offers will be cancelled when CanOffer is disabled.
Description string string Optional (No change made to this value if excluded from JSON data). The item description. If the description contains links or image references, they must all be secure (https://).
FixedPrice decimal positive # Optional (No change made to this value if excluded from JSON data). The price of each item when selling fixed price items.
MfgPartNumber string string The manufacturing part number.
Quantity integer positive # Optional (No change made to this value if excluded from JSON data). The quantity of items for sale. Must be 1 for auctions. Fixed price listings can have any quantity.
ReservePrice decimal positive # Optional (No change made to this value if excluded from JSON data). The price the bidding must reach before you will sell the item.
Note: There is a fee for setting the reserve price. Please see the GunBroker Fees page for more information. Reserve price may not be set for 1 and 3 day listing durations.
StandardTextID int int The ID of the Standard Text for Additional Terms of Sale version linked to the item for StandardTextVersionID
StartingBid decimal positive # Optional (No change made to this value if excluded from JSON data). The starting bid is the the least amount that a user will be able to bid on the item.
SubTitle string string Optional (No change made to this value if excluded from JSON data). The item subtitle. 50 characters maximum, NO HTML, no asterisks, no quotes, NO ALL CAPS. Please note there is an additional charge when adding this feature. Invalid characters will be stripped from the value entered.
Title string string Optional (No change made to this value if excluded from JSON data). The item title. 50 characters maximum, NO HTML, no asterisks, no quotes, NO ALL CAPS. Invalid characters will be stripped from the value entered.

Output

If there are no errors with the input parameters, this call will respond with a 200 OK and a Message Response indicating the item was updated.

Links

Rel Description Condition
self The item details