Requests the deletion of one or more SKU-location records. Deleting a SKUL removes planning history that cannot be restored, so this request is reviewed by GAINS before anything is deleted rather than applied on receipt.
The response returns a task in PendingReview. Nothing has been deleted at that point and nothing has been sent on for processing: the records are held until a GAINS reviewer approves the task through PUT /api/v1/tasks/{taskId}. If the reviewer refuses it, the task moves to RejectedNotApproved and the records are never applied.
Once approved, the request is queued for the next Item Master Loader run, and the task follows the usual Queued / Processing / Completed progression.
To follow the outcome, either poll GET /api/v1/tasks/{taskId}, or subscribe to the task_status_update webhook trigger and filter on Status (for example Status = "PendingReview" or Status = "Completed"). While the task is still PendingReview you can withdraw the request with POST /api/v1/tasks/{taskId}/cancel.
A maximum of 1000 records may be submitted per request.
GainsX Version Requirement:
- Min: 10.0-ER2610
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||