Removing products from the promotion

Info

Console

The method is available for all models.

Not yet available for Market Yandex Go sellers.

If you are using an API Key token, one of the accesses in the list is required to call the method

pricing — Manage prices
promotion — Product promotion
all-methods — Full account management

Removes products from the promotion.

The changes begin to take effect within 4-6 hours. To find out if they have been applied, use the parameter processing in the method's response POST v2/businesses/{businessId}/promos.

⚙️ Limit: 10,000 requests per hour

Request

POST

https://api.partner.market.yandex.ru/v2/businesses/{businessId}/promos/offers/delete

Path parameters

Name

Description

businessId

Type: integer

Cabinet ID. To find out, use the request GET v2/campaigns.

ℹ️ What is a cabinet and a store on the Market?

Min value: 1

Body

application/json

{
  "promoId": "example",
  "deleteAllOffers": true,
  "offerIds": [
    "example"
  ]
}

Name	Description
promoId	Type: string The ID of the promotion. Example: `example`
deleteAllOffers	Type: boolean To remove all products from the promotion and no longer participate in it, pass the value `true` and don't pass the parameter. `offerIds`.
offerIds	Type: string[] \| null Products that need to be removed from the promotion. Min items: `1` Max items: `500` Unique items: `true` Example `[ "example" ]`

Responses

200 OK

The result of removing products from the promotion.

Body

application/json

{
  "status": "OK"
}

Type: object

400 Bad Request

The request contains incorrect data. Learn more about errors when working with stocks

Body

application/json

{
  "status": "OK"
}

Type: object

401 Unauthorized

The authorization data is not specified in the request. More information about the error

Body

application/json

{
  "status": "OK"
}

Type: object

403 Forbidden

The authorization data is incorrect or access to the resource is prohibited. More information about the error

Body

application/json

{
  "status": "OK"
}

Type: object

404 Not Found

The requested resource was not found. More information about the error

Body

application/json

{
  "status": "OK"
}

Type: object

420 Method Failure

The resource access limit has been exceeded. More information about the error

Body

application/json

{
  "status": "OK"
}

Type: object

500 Internal Server Error

Internal error of the Market. More information about the error

Body

application/json

{
  "status": "OK"
}

Type: object

pathParams:
  - description: "Cabinet ID. To find out, use the request [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [What is a cabinet and a store on the Market?](https://yandex.ru/support/marketplace/account/introduction.html)\n"
    name: businessId
    in: path
    required: true
    schema:
      type: integer
      format: int64
      minimum: 1
searchParams: []
headers: []
body: |-
  {
    "promoId": "example",
    "deleteAllOffers": true,
    "offerIds": [
      "example"
    ]
  }
schema:
  description: >
    Removing products from the promotion.


    To remove:


    * all products from the promotion and no longer participate in it, pass the
    value `true` in the parameter
    `deleteAllOffers`;


    * some of the products, pass their IDs in the parameter
    `offersIds`.
  type: object
  required:
    - promoId
  properties:
    promoId:
      description: The ID of the promotion.
      type: string
    deleteAllOffers:
      description: >-
        To remove all products from the promotion and no longer participate in
        it, pass the value `true` and don't pass the parameter.
        `offerIds`.
      type: boolean
    offerIds:
      description: Products that need to be removed from the promotion.
      type: array
      nullable: true
      minItems: 1
      maxItems: 500
      uniqueItems: true
      items:
        description: "Your SKU —\_the product ID in your system.\n\nUsage rules SKU:\n\n* For each product SKU there must be one.\n\n* Already set SKU it cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before.\n\nSKU The product can be changed in the seller's account on the Market. Read about how to do this. [in the Help of the Market for sellers](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku).\n\n{% note warning %}\n\nSpaces at the beginning and end of the value are automatically deleted. For example, `\"  SKU123  \"` and `\"SKU123\"` they will be treated as identical values.\n\n{% endnote %}\n\n[What is SKU and how to assign it](https://yandex.ru/support/marketplace/assortment/add/index.html#fields)\n"
        type: string
        pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$
        x-transform: trim
        minLength: 1
        maxLength: 255
bodyType: application/json
method: post
security:
  - type: apiKey
    name: 'Api-Key'
    in: header
  - type: oauth2
    x-inline: true
    flows:
      implicit:
        authorizationUrl: https://oauth.yandex.ru/authorize
        scopes:
          market:partner-api: API Яндекс.Маркета / Поиска по товарам для партнеров
path: v2/businesses/{businessId}/promos/offers/delete
host: https://api.partner.market.yandex.ru

Was the article helpful?

Adding products to a promotion/changing their prices

Information about orders