StylorDocs

Delete a queue entry

delete/v1/datasets/{datasetId}/items/queue/{itemId}

Removes an entry from the ingest queue. Deleting a pending entry stops it from being processed. Deleting a complete or failed entry means the next upload of that SKU is queued as a new product and fully processed, rather than updating this entry.

Deleting a queue entry never removes a processed item — use the item delete endpoint for that. An entry that is currently processing may still produce an item if the worker finishes before the delete lands.

Private keyapi.v1.datasets.items.queue.deleteNo demo

Path parameters

2
datasetIdstring (uuid)required

The dataset's id, as returned when it was created.

itemIdstring (uuid)required

The queue entry's itemId.

Response

200The queue entry was deleted.
okbooleanrequired

Always true on a successful delete.

e.g. true
deletedCountintegerrequired

Number of records removed. Always 1; a miss is reported as an error instead.

e.g. 1

Errors

20

Every error is JSON with a single error string unless noted. Match on the status code; the message is for humans.

401
Organization not found. Verify the organizationId.

The organization encoded in the API key no longer exists.

404
Dataset not found for this organization.

No dataset with this datasetId belongs to the key's organization.

404
Queued item not found for the given dataset and organization.

The dataset's queue holds no entry with this itemId, or it was already deleted.

curl -X DELETE "https://stylor.ai/api/v1/datasets/YOUR_DATASET_ID/items/queue/YOUR_ITEM_ID" \
  -H "Authorization: Bearer $STYLOR_API_KEY"
Response · 200
{
  "ok": true,
  "deletedCount": 1
}