Allows you to edit an item for sale.
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. |
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. |
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.
Rel | Description | Condition |
---|---|---|
self | The item details |