Skip to main content

Discard Dropship Batch

DELETE 
/api/portal/dropship/batches/:batch

Discards a staged batch you no longer want. No orders are created; the batch stays in the list with status: discarded. Only a batch that has not been submitted can be discarded.

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

Auth: a portal session bearer token, or a portal API key (pfk_…) with the dropship:write scope, sent as Authorization: Bearer. A Viewer-role buyer (or a key owned by one) is refused with 403 viewer_read_only. Requires an enabled dropship program; 60 requests a minute.

Errors: 404 not_found; 422 batch_not_staged when the batch was already submitted or discarded.

Request​

Responses​

OK

Response Headers
    Content-Type