Skip to main content
Altcraft Docs LogoAltcraft Docs Logo
User guideDeveloper guideAdmin guide
Company siteHelp center
English
  • Русский
  • English
v75
Login
  • User API documentation
  • API interaction
  • Matching
  • Profiles
  • Databases
  • Resources
  • Segments
  • Suppression lists
  • Templates and fragments
  • Campaigns
  • Mailings
  • Automation scenarios
  • Loyalty Programs
  • Promo codes
  • Goals
  • Application push notifications
  • Market
    • Market objects
    • Orders
    • Products and SKU
      • Import products, SKUs and categories
      • Import SKUs and categories
      • Get products list
      • Get SKUs list
      • Delete products
      • Delete SKU
  • Analytic reports
  • SendersDev
  • External datatables queries
  • Objects
  • Miscellaneous
  • Importing the API collection in Postman
  • List of API endpoints
  • SDK
  • Market
  • Products and SKU
  • Delete products
Documentation for version v75

Delete products

Description​

Delete products in the marketplace. The method supports both single deletion and batch deletion of multiple products in one request.

To delete, you must use a token for which a role with the appropriate access rights is assigned.

Request URL​

Method: POST

https://example.com/api/v1.1/market/products/delete

Request parameters​

ParameterTypeExampleRequiredDescription
tokenstring"abcdefghijklmnqrstuvwxyz"YesAPI token
idsarray of integers[1, 2, 3]No, if external_ids is providedArray of internal product identifiers
external_idsarray of strings["product_1", "product_2"]No, if ids is providedArray of external product identifiers

Request example​

  • Single JSON
  • Batch JSON
  • Single XML
  • Batch XML

Identification by parameter: "ids":

{           
"token": "abcdefghijklmnqrstuvwxyz",
"ids": [1]
}

Identification by parameter: "external_ids":

{           
"token": "abcdefghijklmnqrstuvwxyz",
"external_ids": ["product_123"]
}
{           
"token": "abcdefghijklmnqrstuvwxyz",
"ids": [1, 2],
"external_ids": ["product_3"]
}

Identification by parameter: "ids":

<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
<ids>1</ids>
</xml>

Identification by parameter: "external_ids":

<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
<external_ids>product_123</external_ids>
</xml>
<xml>
<token>abcdefghijklmnqrstuvwxyz</token>
<ids>1</ids>
<ids>2</ids>
<external_ids>product_3</external_ids>
</xml>

Response example​

  • JSON
  • XML
{
"deleted_count": 2,
"error": 0,
"error_text": ""
}
<xml>
<deleted_count>2</deleted_count>
<error>0</error>
<error_text></error_text>
</xml>

Response parameters​

ParameterTypeDescription
deleted_countintNumber of actually deleted products
errorintError code
error_textstringError text
Last updated on Sep 10, 2024
Previous
Get SKUs list
Next
Delete SKU
  • Description
  • Request URL
  • Request parameters
  • Request example
  • Response example
  • Response parameters
© 2015 - 2025 Altcraft, LLC. All rights reserved.