Delete Existing Items

You can use this API to delete existing items in a given catalog. Only 50 items are allowed to be deleted in a single request.

POST /catalog/{catalog_id}/items/bulk-delete

Delete Existing Items

cURL

curl --request POST \
  --url https://api-{dc}.moengage.com/v1/catalog/{catalog_id}/items/bulk-delete \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    "{{item_ID}}"
  ]
}
'

202

Example

{ "message": { "valid": { "count": 0 }, "invalid": { "count": 10 } } }

Rate Limit Information

Request limit: 100/min OR 1000/hr. You can delete up to 50 items per request. Payload size limit: 5MB (only when Content-Length header is provided).

Authorizations

Authorization · string · header · required

Basic Authentication sends a Base64-encoded string containing your username and password.

You can obtain the username and password from the MoEngage Dashboard:

1. Navigate to Settings > Account > APIs.
2. Username: Copy the Workspace ID.
3. Password: Copy the Catalog API key.

Path Parameters

catalog_id · string · required

The unique identifier for the catalog, obtained during catalog creation.

Body

application/json

items · string[] · required

An array of item IDs to delete from the catalog.

Maximum array length: 50

Response

202

application/json

Accepted. The bulk delete request was processed successfully.

message · object

Show child attributes