Delete Order Bump

Remove an order bump by id. A second call for the same id returns 404. Delete frees a slot in the 10-cap. The same id cannot be reused.

Delete is not hide — use active: false to keep the bump off checkout without removing it. See Active.

Live writes return 409 when the owner product has has_draft: true. Draft deletes require draft_version in the JSON body and return 204 with no body.

Request

Live:

• DELETE /order-bumps/{id}

Draft:

• DELETE /products/{productId}/draft/order-bumps/{id}

Path Parameters

Parameter	Type	Required	Description
productId	string	Draft only	Owner product UUID.
id	string	Yes	Order bump UUID.

Request Body

Live deletes have no body. Draft deletes require:

Parameter	Type	Required	Description
draft_version	integer	Draft only	Current overlay version. Minimum 1. A mismatch returns 409.

Example Request

curl -X DELETE "https://cart.easy.tools/api/v1/order-bumps/4eebbd13-ee35-4d66-bfec-a9988b63ef75" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Draft:

curl -X DELETE "https://cart.easy.tools/api/v1/products/0632bef5-c308-42cd-9cba-89a7a4f722bb/draft/order-bumps/4eebbd13-ee35-4d66-bfec-a9988b63ef75" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "draft_version": 8
  }'

Response

Success Response (204)

Empty body.

Error Responses

Bad Request (400)

{
  "message": "Invalid order bump ID"
}

Not Found Error (404)

{
  "message": "Order bump with ID 4eebbd13-ee35-4d66-bfec-a9988b63ef75 not found"
}

Conflict Error (409 — Unpublished Draft)

Live write while has_draft is true:

{
  "message": "This product has an unpublished draft. Publish, unpublish, or delete the draft before making live changes."
}

Conflict Error (409 — Stale Draft Version)

Draft write when draft_version does not match:

{
  "message": "The draft was edited elsewhere. GET the draft and retry with the current draft_version."
}

Validation Error (422 Unprocessable Entity)

Draft delete missing draft_version:

{
  "message": "The given data was invalid.",
  "errors": {
    "draft_version": ["This field is required."]
  }
}

Unauthorized Error (401)

{
  "message": "Unauthenticated."
}

Forbidden Error (403)

{
  "message": "You do not have API access to the requested store."
}