Delete products (bulk)

Delete multiple products from the catalogue in a single request.

Access Control:

• Requires admin permissions with ManageProducts flag

Important Notes:

• This performs a soft delete (marks as deleted)
• Accepts 1-100 product IDs per request
• Product feature must be enabled in network settings

DELETE /api/v1/products

Delete products (bulk)

cURL

curl --request DELETE \
  --url https://apix.us.amity.co/api/v1/products \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "productIds": [
    "prod-12345",
    "prod-67890",
    "prod-11111"
  ]
}
'

200

{
  "status": "success",
  "data": {
    "success": true
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

productIds · string[] · required

Array of product IDs to delete

Required array length: 1 - 100 elements

Required string length: 1 - 100

Example:

["prod-12345", "prod-67890", "prod-11111"]

Response

200

application/json

Successful response after deleting a product

status · string

Example:

"success"

data · object

Show child attributes