/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 # Optional/Conditional (No change made to this value if excluded from JSON data. Requires the CanOffer=true and AutoRejectPrice fields). The minimum price for an offer to be automatically accepted.
AutoRejectPrice decimal positive # Optional/Conditional (No change made to this value if excluded from JSON data. Requires the CanOffer=true and AutoAcceptPrice fields). 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.
GTIN string Valid GTIN Optional (No change made to this value if excluded from JSON data). The Global Trade Item Number (GTIN) of the item. If the GTIN is also a valid UPC and UPC is not set in the item, this will also update the UPC of the item.
MfgPartNumber string string Optional(No change made to this value if excluded from JSON data). The manufacturing part number.
Prop65Warning string string Optional (No change made to this value if excluded from JSON data). Place the appropriate Proposition 65 messaging here if this applies to your business and product. For more information, visit https://www.p65warnings.ca.gov
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.
SKU string string Optional(No change made to this value if excluded from JSON data). The Stock Keeping Unit (SKU) of the item.
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. 75 characters maximum, NO HTML, no asterisks, no quotes, NO ALL CAPS. Invalid characters will be stripped from the value entered.
UPC string Valid UPC Optional (No change made to this value if excluded from JSON data). The Universal Product Code (UPC) of the item. A valid UPC will add additional searchable characteristics to most firearm listings.
CollectorsElite boolean true/false Optional (No change made to this value if excluded from JSON data). Enables or disables Collector's Elite on the item.

Please Note, you have to be granted permission to list as Collector's Elite.

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