growwer 2.0.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a0c49ac33e995f010044b32e3655251e8ff84e3828755d9c6799f8e1d14789d
-  data.tar.gz: 846c087bce80fb8d64e0e63af63e14f46b00ba48b12d307aa127c277ab215421
+  metadata.gz: d614b99ecc86a69e42e7136f83197ca0e308a558250583ac14ae0e6688fdca47
+  data.tar.gz: 90b5f78dab6b629dfec21c56c60e49f13610851340a0d702a774289370951491
 SHA512:
-  metadata.gz: 5ed381c6f3d9e38bbd1608309229fe250f612587aab80e67c89b0d134a185176395830cbc46f02b639c2decfc50c55f5b63de09577e03d590191f41d7d911dcc
-  data.tar.gz: 672a595a2069af8b7fb59617d5d80231c34f6ffcd4eb7ed82cf53ba42b6334d51853f0421f81f746a6e64d8c5e5971e9b95556b06e9ea0a752f3f1aba2acadf5
+  metadata.gz: 5104993bf0eff025bf072dd6d0f763ec3f40ceb4de052e2a1316f42f2efda92cae62ca8103585cbe403d55d5c43cac3fd745e1a24a1afd9c9580063199f24c97
+  data.tar.gz: a7302b27e95f9b90aa0d941bf018b9b6f9c595e970ed1025742319a31da80bd8293bd24f2f801e1257ac623f7a585e1703d25154b6b29f5686048a1bea57caf7

data/README.md

@@ -25,15 +25,39 @@ operation. Keys belong to your account, not to one API key.
   409 `idempotency_key_reused`. A write without the header gets 400
   `idempotency_key_required`.
 
+Test mode: a test key (`gw_sk_test_` plus 43 characters) works on your
+account's test data alone, apart from the real catalogue: test projects,
+orders and files, and a test wallet that starts at 1,000.00 EUR. Every
+response to a test key carries `Growwer-Mode: test`, and an id of the other
+mode answers 404 as a missing object would.
+- A test order is validated and debited from the test wallet as a live one
+  is. A simulated seller accepts it a minute later and delivers it two
+  minutes after that; you approve the delivery or request an update.
+- The Test helpers top the test wallet up, move a test order on at once and
+  reset your test data. A live key on them gets 403 `test_mode_only`.
+- A test key on the seller and managed service operations, on a project's
+  catalogue writes and on media requests gets 403
+  `not_available_in_test_mode`.
+- Idempotency keys are scoped per mode: the same `Idempotency-Key` sent with
+  a live and a test key never replays the other mode's response.
+
+Webhooks: a subscription receives the events of its mode, signed as Standard
+Webhooks. A subscription created with a live key gets the events of your
+orders and your wallet; one created with a test key gets those of your test
+orders and test wallet, with `mode: test`, and never a live event.
+`x-webhooks` lists every event Growwer POSTs and its payload; the
+WebhookEvent schema describes the headers, the signature and the retries.
+
 Every response carries `X-Request-Id`. Errors share one shape,
 `{code, message, requestId, details?}`. Money is integer cents plus a
-currency code and dates are ISO-8601.
+currency code (12500 is 125.00 EUR), answered with `amountDecimal`, the same
+amount as an exact decimal string (\"125.00\"); dates are ISO-8601.
 
 
 This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 1
-- Package version: 2.0.0
+- Package version: 2.2.0
 - Generator version: 7.24.0
 - Build package: org.openapitools.codegen.languages.RubyClientCodegen
 For more information, please visit [https://growwer.com/contact/](https://growwer.com/contact/)
@@ -51,16 +75,16 @@ gem build growwer.gemspec
 Then either install the gem locally:
 
 ```shell
-gem install ./growwer-2.0.0.gem
+gem install ./growwer-2.2.0.gem
 ```
 
-(for development, run `gem install --dev ./growwer-2.0.0.gem` to install the development dependencies)
+(for development, run `gem install --dev ./growwer-2.2.0.gem` to install the development dependencies)
 
 or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
 
 Finally add this to the Gemfile:
 
-    gem 'growwer', '~> 2.0.0'
+    gem 'growwer', '~> 2.2.0'
 
 ### Install from Git
 
@@ -157,7 +181,7 @@ Class | Method | HTTP request | Description
 *Growwer::SavedFiltersApi* | [**delete_saved_filter**](docs/SavedFiltersApi.md#delete_saved_filter) | **DELETE** /api/v1/projects/{id}/saved-filters/{filterId} | Delete a saved filter
 *Growwer::SavedFiltersApi* | [**list_saved_filters**](docs/SavedFiltersApi.md#list_saved_filters) | **GET** /api/v1/projects/{id}/saved-filters | List the saved filters of a project
 *Growwer::SellerAccountApi* | [**put_seller_holiday**](docs/SellerAccountApi.md#put_seller_holiday) | **PUT** /api/v1/seller/holiday | Set your holiday
-*Growwer::SellerMediasApi* | [**apply_seller_media_competitive_fees**](docs/SellerMediasApi.md#apply_seller_media_competitive_fees) | **POST** /api/v1/seller/medias/{id}/apply-competitive-fees | Set the competitive fees Growwer suggests
+*Growwer::SellerMediasApi* | [**apply_seller_media_competitive_fees**](docs/SellerMediasApi.md#apply_seller_media_competitive_fees) | **POST** /api/v1/seller/medias/{id}/apply-competitive-fees | Lower your fees to the competitive fees Growwer suggests
 *Growwer::SellerMediasApi* | [**create_seller_media**](docs/SellerMediasApi.md#create_seller_media) | **POST** /api/v1/seller/medias | Register a media you sell on
 *Growwer::SellerMediasApi* | [**delete_seller_media**](docs/SellerMediasApi.md#delete_seller_media) | **DELETE** /api/v1/seller/medias/{id} | Delete a media you sell on
 *Growwer::SellerMediasApi* | [**get_seller_media**](docs/SellerMediasApi.md#get_seller_media) | **GET** /api/v1/seller/medias/{id} | Get a media you sell on
@@ -180,11 +204,26 @@ Class | Method | HTTP request | Description
 *Growwer::SellerWalletApi* | [**get_seller_wallet**](docs/SellerWalletApi.md#get_seller_wallet) | **GET** /api/v1/wallets/seller | Get your seller wallet
 *Growwer::SellerWalletApi* | [**list_seller_transactions**](docs/SellerWalletApi.md#list_seller_transactions) | **GET** /api/v1/wallets/seller/transactions | List your seller wallet movements
 *Growwer::SellerWalletApi* | [**list_withdrawals**](docs/SellerWalletApi.md#list_withdrawals) | **GET** /api/v1/withdrawals | List your withdrawals
+*Growwer::TestHelpersApi* | [**advance_test_order**](docs/TestHelpersApi.md#advance_test_order) | **POST** /api/v1/test-helpers/orders/{id}/advance | Advance a test order
+*Growwer::TestHelpersApi* | [**reset_test_data**](docs/TestHelpersApi.md#reset_test_data) | **POST** /api/v1/test-helpers/reset | Reset your test data
+*Growwer::TestHelpersApi* | [**top_up_test_wallet**](docs/TestHelpersApi.md#top_up_test_wallet) | **POST** /api/v1/test-helpers/wallet/top-up | Top up your test wallet
+*Growwer::WebhooksApi* | [**create_webhook**](docs/WebhooksApi.md#create_webhook) | **POST** /api/v1/webhooks | Create a webhook subscription
+*Growwer::WebhooksApi* | [**delete_webhook**](docs/WebhooksApi.md#delete_webhook) | **DELETE** /api/v1/webhooks/{id} | Delete a webhook subscription
+*Growwer::WebhooksApi* | [**get_webhook**](docs/WebhooksApi.md#get_webhook) | **GET** /api/v1/webhooks/{id} | Get a webhook subscription
+*Growwer::WebhooksApi* | [**list_webhook_deliveries**](docs/WebhooksApi.md#list_webhook_deliveries) | **GET** /api/v1/webhooks/{id}/deliveries | List the deliveries of a webhook subscription
+*Growwer::WebhooksApi* | [**list_webhooks**](docs/WebhooksApi.md#list_webhooks) | **GET** /api/v1/webhooks | List your webhook subscriptions
+*Growwer::WebhooksApi* | [**redeliver_webhook**](docs/WebhooksApi.md#redeliver_webhook) | **POST** /api/v1/webhooks/{id}/deliveries/{deliveryId}/redeliver | Redeliver a webhook event
+*Growwer::WebhooksApi* | [**rotate_webhook_secret**](docs/WebhooksApi.md#rotate_webhook_secret) | **POST** /api/v1/webhooks/{id}/rotate-secret | Rotate a webhook secret
+*Growwer::WebhooksApi* | [**send_webhook_test**](docs/WebhooksApi.md#send_webhook_test) | **POST** /api/v1/webhooks/{id}/test | Send a test event
+*Growwer::WebhooksApi* | [**update_webhook**](docs/WebhooksApi.md#update_webhook) | **PATCH** /api/v1/webhooks/{id} | Edit a webhook subscription
 
 
 ## Documentation for Models
 
+ - [Growwer::AdvanceTestOrderRequest](docs/AdvanceTestOrderRequest.md)
  - [Growwer::Balance](docs/Balance.md)
+ - [Growwer::BalanceLowEventData](docs/BalanceLowEventData.md)
+ - [Growwer::BalanceLowEventDataWallet](docs/BalanceLowEventDataWallet.md)
  - [Growwer::CatalogueMedia](docs/CatalogueMedia.md)
  - [Growwer::CatalogueMediaFlashOffer](docs/CatalogueMediaFlashOffer.md)
  - [Growwer::CatalogueMediaMetrics](docs/CatalogueMediaMetrics.md)
@@ -199,6 +238,7 @@ Class | Method | HTTP request | Description
  - [Growwer::CreateSavedFilterRequest](docs/CreateSavedFilterRequest.md)
  - [Growwer::CreateSellerMediaRequest](docs/CreateSellerMediaRequest.md)
  - [Growwer::CreateSellerMediaRequestPostOffer](docs/CreateSellerMediaRequestPostOffer.md)
+ - [Growwer::CreateWebhookRequest](docs/CreateWebhookRequest.md)
  - [Growwer::Error](docs/Error.md)
  - [Growwer::GetBuyerWallet200Response](docs/GetBuyerWallet200Response.md)
  - [Growwer::GetMe200Response](docs/GetMe200Response.md)
@@ -223,6 +263,8 @@ Class | Method | HTTP request | Description
  - [Growwer::ListSellerMedias200Response](docs/ListSellerMedias200Response.md)
  - [Growwer::ListSellerOrders200Response](docs/ListSellerOrders200Response.md)
  - [Growwer::ListSellerTransactions200Response](docs/ListSellerTransactions200Response.md)
+ - [Growwer::ListWebhookDeliveries200Response](docs/ListWebhookDeliveries200Response.md)
+ - [Growwer::ListWebhooks200Response](docs/ListWebhooks200Response.md)
  - [Growwer::ListWithdrawals200Response](docs/ListWithdrawals200Response.md)
  - [Growwer::ManagedServiceCampaign](docs/ManagedServiceCampaign.md)
  - [Growwer::ManagedServiceCampaignProject](docs/ManagedServiceCampaignProject.md)
@@ -251,6 +293,7 @@ Class | Method | HTTP request | Description
  - [Growwer::OrderEstimate](docs/OrderEstimate.md)
  - [Growwer::OrderEstimateRequest](docs/OrderEstimateRequest.md)
  - [Growwer::OrderEstimateRequestBriefing](docs/OrderEstimateRequestBriefing.md)
+ - [Growwer::OrderEventData](docs/OrderEventData.md)
  - [Growwer::OrderLink](docs/OrderLink.md)
  - [Growwer::OrderLinkRequest](docs/OrderLinkRequest.md)
  - [Growwer::OrderMedia](docs/OrderMedia.md)
@@ -272,6 +315,7 @@ Class | Method | HTTP request | Description
  - [Growwer::SellerFees](docs/SellerFees.md)
  - [Growwer::SellerFeesOrNull](docs/SellerFeesOrNull.md)
  - [Growwer::SellerMedia](docs/SellerMedia.md)
+ - [Growwer::SellerMediaCompetitiveFeesByLinkTypeInner](docs/SellerMediaCompetitiveFeesByLinkTypeInner.md)
  - [Growwer::SellerMediaFlashOffer](docs/SellerMediaFlashOffer.md)
  - [Growwer::SellerMediaLinkAdditionOffer](docs/SellerMediaLinkAdditionOffer.md)
  - [Growwer::SellerMediaLinkAdditionOfferPricingOptionsInner](docs/SellerMediaLinkAdditionOfferPricingOptionsInner.md)
@@ -289,6 +333,8 @@ Class | Method | HTTP request | Description
  - [Growwer::SellerOrderRejectionReason](docs/SellerOrderRejectionReason.md)
  - [Growwer::SellerPostOrderBriefing](docs/SellerPostOrderBriefing.md)
  - [Growwer::SellerTransaction](docs/SellerTransaction.md)
+ - [Growwer::TopUpTestWallet200Response](docs/TopUpTestWallet200Response.md)
+ - [Growwer::TopUpTestWalletRequest](docs/TopUpTestWalletRequest.md)
  - [Growwer::Transaction](docs/Transaction.md)
  - [Growwer::UpdateProjectRequest](docs/UpdateProjectRequest.md)
  - [Growwer::UpdateSellerMediaRequest](docs/UpdateSellerMediaRequest.md)
@@ -297,7 +343,16 @@ Class | Method | HTTP request | Description
  - [Growwer::UpdateSellerMediaRequestLinkAdditionOfferPricingOptionsInner](docs/UpdateSellerMediaRequestLinkAdditionOfferPricingOptionsInner.md)
  - [Growwer::UpdateSellerMediaRequestPostOffer](docs/UpdateSellerMediaRequestPostOffer.md)
  - [Growwer::UpdateSellerMediaRequestPostOfferPricingOptionsInner](docs/UpdateSellerMediaRequestPostOfferPricingOptionsInner.md)
+ - [Growwer::UpdateWebhookRequest](docs/UpdateWebhookRequest.md)
  - [Growwer::UploadFile201Response](docs/UploadFile201Response.md)
+ - [Growwer::Webhook](docs/Webhook.md)
+ - [Growwer::WebhookDelivery](docs/WebhookDelivery.md)
+ - [Growwer::WebhookDeliveryAttempt](docs/WebhookDeliveryAttempt.md)
+ - [Growwer::WebhookEvent](docs/WebhookEvent.md)
+ - [Growwer::WebhookEventData](docs/WebhookEventData.md)
+ - [Growwer::WebhookEventType](docs/WebhookEventType.md)
+ - [Growwer::WebhookTestEventData](docs/WebhookTestEventData.md)
+ - [Growwer::WebhookWithSecret](docs/WebhookWithSecret.md)
  - [Growwer::Withdrawal](docs/Withdrawal.md)
 
 

data/docs/AccountApi.md

@@ -14,7 +14,7 @@ All URIs are relative to *https://tool.growwer.com*
 
 Your account
 
-Profile basics, the buyer and seller balances, whether your seller account is restricted, whether the catalogue is open to you, and whether you have a managed service.
+Profile basics, the buyer and seller balances, whether your seller account is restricted, whether the catalogue is open to you, whether you have a managed service, and whether the key you called with is live or test. A test key reads its test wallet as the buyer balance (1,000.00 EUR until test orders and top-ups move it), never your real balance, and no seller side.
 
 ### Examples
 

data/docs/AdvanceTestOrderRequest.md

@@ -0,0 +1,18 @@
+# Growwer::AdvanceTestOrderRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **to** | **String** | The state to move the test order to. |  |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::AdvanceTestOrderRequest.new(
+  to: null
+)
+```
+

data/docs/BalanceLowEventData.md

@@ -0,0 +1,20 @@
+# Growwer::BalanceLowEventData
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **wallet** | [**BalanceLowEventDataWallet**](BalanceLowEventDataWallet.md) |  |  |
+| **threshold** | [**Money**](Money.md) | The subscription's `lowBalanceThreshold` that the balance dropped below. |  |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::BalanceLowEventData.new(
+  wallet: null,
+  threshold: null
+)
+```
+

data/docs/BalanceLowEventDataWallet.md

@@ -0,0 +1,20 @@
+# Growwer::BalanceLowEventDataWallet
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **available_balance** | [**Money**](Money.md) |  |  |
+| **currency** | **String** | The currency of the wallet. |  |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::BalanceLowEventDataWallet.new(
+  available_balance: null,
+  currency: EUR
+)
+```
+

data/docs/CatalogueApi.md

@@ -592,7 +592,7 @@ end
 
 Restore a discarded media for a project
 
-Restores a media you discarded for one of your projects. Restoring one that is not discarded changes nothing. It works for any media, even one the catalogue no longer shows.
+Restores a media you discarded for one of your projects. Restoring one that is not discarded, or an id no media has, changes nothing and answers the same. It works for any media, even one the catalogue no longer shows.
 
 ### Examples
 
@@ -664,7 +664,7 @@ nil (empty response body)
 
 Remove a media from the favourites of a project
 
-Removes a media from the favourites of one of your projects. Removing one that is not a favourite changes nothing. It works for any media, even one the catalogue no longer shows.
+Removes a media from the favourites of one of your projects. Removing one that is not a favourite, or an id no media has, changes nothing and answers the same. It works for any media, even one the catalogue no longer shows.
 
 ### Examples
 

data/docs/CreateWebhookRequest.md

@@ -0,0 +1,24 @@
+# Growwer::CreateWebhookRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **url** | **String** | An HTTPS URL of at most 2048 characters, without a backslash or credentials. Its host is an IP address or a domain name of two labels or more, such as hooks.example.com, with one trailing dot allowed; a single-label host such as localhost is refused (`validation_failed` on `url`). The host is checked, and resolved at each delivery, in lower case and with a Unicode name in punycode, the form a delivery connects to. |  |
+| **events** | [**Array<WebhookEventType>**](WebhookEventType.md) | The events to send, at least one. |  |
+| **low_balance_threshold** | [**Money**](Money.md) | With `balance.low`: the available buyer balance below which the event fires, in EUR. | [optional] |
+| **description** | **String** | A note of yours, at most 255 characters. | [optional] |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::CreateWebhookRequest.new(
+  url: null,
+  events: null,
+  low_balance_threshold: null,
+  description: null
+)
+```
+

data/docs/GetMe200Response.md

@@ -13,6 +13,7 @@
 | **seller** | [**GetMe200ResponseSeller**](GetMe200ResponseSeller.md) |  |  |
 | **catalogue** | [**GetMe200ResponseCatalogue**](GetMe200ResponseCatalogue.md) |  |  |
 | **managed_service** | [**GetMe200ResponseManagedService**](GetMe200ResponseManagedService.md) |  |  |
+| **mode** | **String** | The mode of the key you called with. `live` works on your real account; `test` works in test mode, where nothing you do reaches real sellers, money or orders. Every response to a test key also carries the header `Growwer-Mode: test`. |  |
 
 ## Example
 
@@ -28,7 +29,8 @@ instance = Growwer::GetMe200Response.new(
   buyer: null,
   seller: null,
   catalogue: null,
-  managed_service: null
+  managed_service: null,
+  mode: null
 )
 ```
 

data/docs/ListWebhookDeliveries200Response.md

@@ -0,0 +1,20 @@
+# Growwer::ListWebhookDeliveries200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **items** | [**Array<WebhookDelivery>**](WebhookDelivery.md) |  |  |
+| **total** | **Integer** |  |  |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::ListWebhookDeliveries200Response.new(
+  items: null,
+  total: null
+)
+```
+

data/docs/ListWebhooks200Response.md

@@ -0,0 +1,20 @@
+# Growwer::ListWebhooks200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **items** | [**Array<Webhook>**](Webhook.md) |  |  |
+| **total** | **Integer** |  |  |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::ListWebhooks200Response.new(
+  items: null,
+  total: null
+)
+```
+

data/docs/Money.md

@@ -4,8 +4,9 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **amount** | **Integer** | Integer cents. |  |
+| **amount** | **Integer** | Integer cents: 12500 is 125.00 EUR. |  |
 | **currency** | **String** | ISO 4217 currency code. |  |
+| **amount_decimal** | **String** | Exact decimal of `amount` in major units: \"125.00\". An input may only echo it unchanged. | [optional][readonly] |
 
 ## Example
 
@@ -14,7 +15,8 @@ require 'growwer'
 
 instance = Growwer::Money.new(
   amount: 12500,
-  currency: EUR
+  currency: EUR,
+  amount_decimal: 125.00
 )
 ```
 

data/docs/MoneyOrNull.md

@@ -4,8 +4,9 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **amount** | **Integer** | Integer cents. |  |
+| **amount** | **Integer** | Integer cents: 12500 is 125.00 EUR. |  |
 | **currency** | **String** | ISO 4217 currency code. |  |
+| **amount_decimal** | **String** | Exact decimal of `amount` in major units: \"125.00\". An input may only echo it unchanged. | [optional][readonly] |
 
 ## Example
 
@@ -14,7 +15,8 @@ require 'growwer'
 
 instance = Growwer::MoneyOrNull.new(
   amount: 12500,
-  currency: EUR
+  currency: EUR,
+  amount_decimal: 125.00
 )
 ```
 

data/docs/OrderCreateRequest.md

@@ -11,7 +11,7 @@
 | **scheduled_publication_date** | **Date** | The day to publish on, at least a few days ahead as the web requires. | [optional] |
 | **draft_reviewable** | **Boolean** | Whether you review the draft before it is published. Defaults to false. | [optional] |
 | **proposed_draft_file_id** | **String** | A file uploaded with POST /files to propose your own draft. The estimate checks it without using it up. | [optional] |
-| **expected_price** | [**Money**](Money.md) | The `price` POST /orders/estimate answered. Only EUR is accepted. |  |
+| **expected_price** | [**Money**](Money.md) | The `price` POST /orders/estimate answered. Only EUR is accepted. In cents, as the estimate answered it: 1800 is 18.00 EUR. |  |
 
 ## Example
 

data/docs/OrderEventData.md

@@ -0,0 +1,18 @@
+# Growwer::OrderEventData
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **order** | [**Order**](Order.md) |  |  |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::OrderEventData.new(
+  order: null
+)
+```
+

data/docs/SellerMedia.md

@@ -22,7 +22,8 @@
 | **flash_offer** | [**SellerMediaFlashOffer**](SellerMediaFlashOffer.md) |  |  |
 | **post_offer** | [**SellerMediaPostOffer**](SellerMediaPostOffer.md) |  |  |
 | **link_addition_offer** | [**SellerMediaLinkAdditionOffer**](SellerMediaLinkAdditionOffer.md) |  |  |
-| **competitive_fees** | [**SellerFeesOrNull**](SellerFeesOrNull.md) | The post fees Growwer suggests to sell more, as the seller media page does, or null when it suggests none. A side Growwer finds no competitive fee for is null: unlike the page, it never shows the fixed fee the page falls back to. POST /seller/medias/{id}/apply-competitive-fees sets them. |  |
+| **competitive_fees** | [**SellerFeesOrNull**](SellerFeesOrNull.md) | The post fees Growwer suggests to sell more, as the seller media pages do, or null when it suggests none: for each side, the highest fee POST /seller/medias/{id}/apply-competitive-fees would set on that side, else null. The apply lowers, per link type, a fee above the highest whole-euro fee that lists the media at least 1 EUR below its cheapest price on the marketplaces Growwer compares with to that fee, and lowers by 1 EUR one fee of a link type that then still does not list the media at least 1 EUR below that price. It never raises a fee. Where it lowers several link types, this is the highest per side across them, so a link type's own new fee can be lower: `competitiveFeesByLinkType` gives the fees the apply sets on each link type. |  |
+| **competitive_fees_by_link_type** | [**Array<SellerMediaCompetitiveFeesByLinkTypeInner>**](SellerMediaCompetitiveFeesByLinkTypeInner.md) | The fees POST /seller/medias/{id}/apply-competitive-fees would set, per link type: one entry per link type it lowers, in the order dofollow, nofollow, citation, or null when it suggests none (exactly when `competitiveFees` is null). Per side, the highest of these is `competitiveFees`. |  |
 | **created_at** | **Time** |  |  |
 
 ## Example
@@ -50,6 +51,7 @@ instance = Growwer::SellerMedia.new(
   post_offer: null,
   link_addition_offer: null,
   competitive_fees: null,
+  competitive_fees_by_link_type: null,
   created_at: null
 )
 ```

data/docs/SellerMediaCompetitiveFeesByLinkTypeInner.md

@@ -0,0 +1,22 @@
+# Growwer::SellerMediaCompetitiveFeesByLinkTypeInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **link_type** | **String** |  |  |
+| **fee_when_seller_writes_post** | [**MoneyOrNull**](MoneyOrNull.md) | The fee the apply sets for a post you write on this link type, or null when it keeps your fee on that side. |  |
+| **fee_when_seller_does_not_write_post** | [**MoneyOrNull**](MoneyOrNull.md) | The fee the apply sets for a post the buyer or Growwer writes on this link type, or null when it keeps your fee on that side. |  |
+
+## Example
+
+```ruby
+require 'growwer'
+
+instance = Growwer::SellerMediaCompetitiveFeesByLinkTypeInner.new(
+  link_type: null,
+  fee_when_seller_writes_post: null,
+  fee_when_seller_does_not_write_post: null
+)
+```
+

data/docs/SellerMediasApi.md

@@ -4,7 +4,7 @@ All URIs are relative to *https://tool.growwer.com*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
-| [**apply_seller_media_competitive_fees**](SellerMediasApi.md#apply_seller_media_competitive_fees) | **POST** /api/v1/seller/medias/{id}/apply-competitive-fees | Set the competitive fees Growwer suggests |
+| [**apply_seller_media_competitive_fees**](SellerMediasApi.md#apply_seller_media_competitive_fees) | **POST** /api/v1/seller/medias/{id}/apply-competitive-fees | Lower your fees to the competitive fees Growwer suggests |
 | [**create_seller_media**](SellerMediasApi.md#create_seller_media) | **POST** /api/v1/seller/medias | Register a media you sell on |
 | [**delete_seller_media**](SellerMediasApi.md#delete_seller_media) | **DELETE** /api/v1/seller/medias/{id} | Delete a media you sell on |
 | [**get_seller_media**](SellerMediasApi.md#get_seller_media) | **GET** /api/v1/seller/medias/{id} | Get a media you sell on |
@@ -16,9 +16,9 @@ All URIs are relative to *https://tool.growwer.com*
 
 > <SellerMedia> apply_seller_media_competitive_fees(id, idempotency_key)
 
-Set the competitive fees Growwer suggests
+Lower your fees to the competitive fees Growwer suggests
 
-Sets your post fees for the media to the competitive fees Growwer suggests, the `competitiveFees` of GET /seller/medias/{id}, as the button on the media edit page does. Each link type you offer gets the suggested fee on each side it already has a fee for; no link type gains a side it did not offer.  Two differences from the page: a side Growwer has no suggestion for keeps your fee (the page clears it), and the fixed fee the page falls back to when it cannot find a competitive one is never applied (the page applies it). When neither side has a suggestion, nothing changes and the answer is 409 `no_competitive_fees`. When your fees already are the suggested ones, or the suggestion is only for a side none of your link types offers, nothing changes and the answer is 200.  The fees set are your base fees: a running flash offer keeps discounting them. As with a fee edit, a change of the price may cancel the managed-service proposals accepted for the media whose price it changes. Send no body, or an empty object.
+Lowers your post fees for the media to the competitive fees Growwer suggests, per link type. On each side, a fee above the highest whole-euro fee that lists the media at least 1 EUR below its cheapest price on the marketplaces Growwer compares with is lowered to that fee, and a link type that then still does not list the media at least 1 EUR below that price has one of its fees lowered by 1 EUR, which does. GET /seller/medias/{id} shows, per side, the highest fee this sets on that side as `competitiveFees`, and the fees it sets on each link type it lowers as `competitiveFeesByLinkType`. Only fees above their suggestion change: a fee is never raised, a cheaper link type keeps its fee, no link type gains a side it did not offer, and a side without a suggestion keeps your fee.  When there is no suggestion (Growwer sets the media's prices, it is not listed on a marketplace Growwer compares with, it already lists below its price there, or no fee would bring it below), or your fees already are at or below the suggested ones, nothing changes and the answer is 200 with the media as it is.  The fees set are your base fees: a running flash offer keeps discounting them. As with a fee edit, a change of the price may cancel the managed-service proposals accepted for the media whose price it changes. Send no body, or an empty object.
 
 ### Examples
 
@@ -36,7 +36,7 @@ id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String |
 idempotency_key = 'idempotency_key_example' # String | A new key for each write, reused only to retry that same write. 1 to 255 printable ASCII characters without spaces (`!` to `~`); any other value answers 400 `invalid_idempotency_key`.
 
 begin
-  # Set the competitive fees Growwer suggests
+  # Lower your fees to the competitive fees Growwer suggests
   result = api_instance.apply_seller_media_competitive_fees(id, idempotency_key)
   p result
 rescue Growwer::ApiError => e
@@ -52,7 +52,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Set the competitive fees Growwer suggests
+  # Lower your fees to the competitive fees Growwer suggests
   data, status_code, headers = api_instance.apply_seller_media_competitive_fees_with_http_info(id, idempotency_key)
   p status_code # => 2xx
   p headers # => { ... }