S_updateAuction

Allows to update your existing auction.

Only plain text keys are supported by this mutation.

This mutation is rate-limited. You can update each auction only once every 30 seconds.

Supported arguments

The following arguments are supported by S_updateAuction mutation:

Field	Type	Description
`input`	S_API_UpdateAuctionInput!	Auction update data

Return type

The mutation returns the S_API_UpdateAuctionResponse type.

Example usage

There are a few scenarios how auction might be updated, here we will list the most popular ones.

Plain auction

This approach should be taken if you are selling keys for already released game, you have keys on your side, and you're willing to upload those to Eneba.

Mutation

In the following mutation we are updating an existing auction - we are adding two new keys (addedKeys) and removing two previous keys (removedKeys), we are also changing the auction price.

Please be informed that you have a limited number of free price changes, you may check your quota with S_stock query. The quota is under the priceUpdateQuota field.

mutation {
  S_updateAuction(
    input: {
      id: "92c73bdc-80d4-1041-a4de-c12cc3d288c0"
      addedKeys: ["key-one", "key-two"]
      removedKeys: ["2f6ea446-507e-11ed-bdc3-0242ac120002", "2f6ea78e-507e-11ed-bdc3-0242ac120002"]
      price: { amount: 1399, currency: "EUR" }
    }
  ) {
    success
    actionId
    addedKeys { id }
    price { amount currency }
    priceChanged
    paidForPriceChange
  }
}

Response

You might want to save the addedKeys identifiers for later usage. Otherwise, you can always get your keys by using the S_keys query.

{
  "data": {
    "S_updateAuction": {
      "success": true,
      "actionId": "2f6ea78e-507e-11ed-bdc3-0242ac120002",
      "addedKeys": [
        { "id": "cbba4ec6-507f-11ed-bdc3-0242ac120002" },
        { "id": "cbba5376-507f-11ed-bdc3-0242ac120002" }
      ],
      "price": { "amount": 1399, "currency": "EUR" },
      "priceChanged": true,
      "paidForPriceChange": false
    }
  }
}

"Declared Stock" auction

If you already have created an auction with the "Declared Stock" feature enabled, you probably want to update the declaredStock value.

Please read more on "Declared Stock" feature on automating your stock page.

Mutation

mutation {
  S_updateAuction(
    input: {
      id: "92c73bdc-80d4-1041-a4de-c12cc3d288c0"
      declaredStock: 100
    }
  ) {
    success
    actionId
  }
}

To disable the "Declared Stock" feature, please send the declaredStock: null. Setting it to 0 will not disable the feature.

Response

{
  "data": {
    "S_updateAuction": {
      "success": true,
      "actionId": "2f6ea78e-507e-11ed-bdc3-0242ac120002"
    }
  }
}

Mutation

In the following mutation we are updating an existing auction - we are changing the auction price with "priceIWantToGet".

You can avoid updating the price when you have no free quota left by adding the input field preventPaidPriceChange. Our system will return a specific error message if there are no free updates left and preventPaidPriceChange is set to true

mutation {
  S_updateAuction(
    input: {
      id: "92c73bdc-80d4-1041-a4de-c12cc3d288c0"
      priceIWantToGet: { amount: 1000, currency: "EUR" }
    }
  ) {
    success
    actionId
    price { amount currency }
    priceChanged
    paidForPriceChange
  }
}

Response

{
  "data": {
    "S_updateAuction": {
      "success": true,
      "actionId": "2f6ea78e-507e-11ed-bdc3-0242ac120002",
      "price": { "amount": 1089, "currency": "EUR" },
      "priceChanged": true,
      "paidForPriceChange": false
    }
  }
}