Delete several inventory lines
Removes up to 200 inventory lines in one call, whatever their quantity, and cancels the listing of any that are for sale. Name each line by inventoryId or by your own customId.
The lines are removed together, once you hold no other update. A line that no longer exists counts as deleted (alreadyGone), so repeating the call ends in the same state. A customId of a removed line becomes available for reuse. Deleted lines cannot be restored.
To delete many lines chosen by a filter, use POST /v1/inventory/bulk/edit/preview with the delete action, then confirm.
Send an Idempotency-Key header to make retries safe: the same key returns the same response for 24 hours.
Requires the inventory:write scope.
Body
- Type: array of object 1…200itemsrequiredProperties: 2
The lines to delete — between 1 and 200 per call. A line may appear once.
Responses
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
curl https://public-api.cardnexus.com/v1/inventory/bulk/delete \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"items": [
{
"inventoryId": "",
"customId": "YRG|5555-5DS1-2EX-006-f-2-2008-08-01"
}
]
}'
{
"results": [
{
"index": 0,
"status": "ok",
"inventoryId": "6650f1c2a4b3e2d1c0b9a8f7",
"alreadyGone": false,
"code": null,
"data": null
},
{
"index": 1,
"status": "ok",
"inventoryId": "6650f1c2a4b3e2d1c0b9a8e2",
"alreadyGone": true,
"code": null,
"data": null
},
{
"index": 2,
"status": "ok",
"inventoryId": null,
"alreadyGone": true,
"code": null,
"data": null
}
]
}