Bulk Delete Target Plus Orders
POST/api/target-plus/:integrationInstance/orders/bulk-delete
Deletes the chosen Target Plus order records from SKU.io together with their linked SKU.io sales orders. Nothing changes on Target, and a later pull that covers these orders imports them again. An order whose SKU.io sales order may not be deleted (for example it has received returns, PayPal payments or credits) is kept whole and reported, and the rest are still deleted. To delete only the SKU.io sales orders and keep the Target Plus orders, use Bulk Delete SKU Orders for Target Plus Orders.
integrations:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
One order is deleted right away (tracked_job_log_id is null; 422 with the reason when its sales order may not be deleted). Two or more run as a background job: the response returns the tracked job ID and the number of orders queued, and the job result lists any order that was not deleted.
Body: mode (optional, selected (default) or all), ids (array of order IDs, required unless mode is all, max 5000), filters (optional object, used when mode is all: the same filter keys List Target Plus Orders accepts, without the filter[...] wrapper, e.g. {"needs_action": "unmapped_product"}). IDs that belong to another integration are ignored. Archived orders are excluded from mode: all unless filters includes an archived filter.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.