Update Offer

The following API allow you to update an offer/auction on Driffle.

Rate Limiting applies to this API endpoint and is set to 1 request per 3 seconds.

PATCH /offer/update

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

  {
    "offerId": 0,
    "yourPrice": 0,
    "retailPrice": 0,
    "toggleOffer": "disable",
    "declaredStock": 100000,
    "auctionedKeys": 100,
    "wholesale":{
        "enabled": true,
        "tiers": [
            {
                "level": 1,
                "discount": 10
            },
            {
                "level": 2,
                "discount": 15
            }
          ]
     },
     "automatePriceOptions": {
        "lowerPriceLimit": 8.99,
        "upperPriceLimit": 12.99,
        "priceChangeFactor": 0.05,
        "priceChangeInterval": 3600,
        "automatePriceStatus": "enable"
    }
  }

Param	Description	Param Type	Type	Required
offerId	ID of the Offer	body	number	Yes
yourPrice	"You get" price. commission will be applied to this price.	body	number	No
retailPrice	"Retail Price" is the price after commission. Buyers will see this price	body	number	No
toggleOffer	"enable" or "disable" offer	body	string	No
declaredStock	Number of keys to sell through declared stock feature - optional	body	string	No
auctionedKeys	Maximum number of orders you can accept for a product - optional (Only in preReleased products)	body	number	No
wholesale	Specifies wholesale enable status and tier-based discounts by purchase quantity. Wholesale Pricing Feature	body	{"enabled":true,"tiers":[{"level":1,"discount":10},{"level":2,"discount":15}]}	No
automatePriceOptions	configures automated price adjustments for an offer Automate Pricing	body	{"lowerPriceLimit":8.99,"upperPriceLimit":12.99,"priceChangeFactor":0.05,"priceChangeInterval":3600,"automatePriceStatus":"enable"}	No

Response

200

{
  "message": "string",
  "statusCode": 200,
  "data": "string"
}

400

401

403

500

patch

Header parameters

AuthorizationstringRequired

Authorization token in Bearer format. Example: Bearer dvakycjgw8liyd278y

Body

application/json

offerIdnumberRequired

yourPricenumberOptional

Your price. Commission is calculated on this price.

retailPricenumberOptional

Retail Price is the price after commission. Buyers will see this price.

toggleOfferstring · enumOptional

This field expects either enable or disable keywords to update offer toggle.

Possible values:

declaredStocknumber · max: 100000Optional

Responses

200

Default Response

application/json

400

Bad Request. Wrong/Invalid params format.

application/json

401

UnAuthorized request. Invalid/Expired token

application/json

403

Forbidden Request. Action not allowed or Rate Limit exhausted.

application/json

500

Server Error.

application/json

patch

/offer/update

HTTPcURLJavaScriptPython

PATCH /api/seller/legacy/offer/update HTTP/1.1
Host: services.driffle.com
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 85

{
  "offerId": 1,
  "yourPrice": 1,
  "retailPrice": 1,
  "toggleOffer": "disable",
  "declaredStock": 1
}

{
  "message": "text",
  "statusCode": 1,
  "data": null
}