iotoms Docs

Remove a cart reservation

DELETE
/api/v1/inventory/reservations/{id}

Releases a reservation with the reason CART_REMOVED, typically when an item is taken out of a cart. Equivalent to the release endpoint with that reason.

How to use it

  1. Take the reservation id of the item removed from the cart, from List reservations for a reference.
  2. Call delete; the reservation becomes RELEASED with reason CART_REMOVED and the stock is available again.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

id*string

ID of the record (UUID).

Formatuuid

Header Parameters

Response Body

OK

*/*
  1. response
status*string

Outcome of the call: SUCCESS when the request was handled, ERROR otherwise.

message*string

Short human-readable message describing the outcome, e.g. which record was fetched or saved.

data?

The stock reservation.

Example Request
curl -X DELETE 'https://beta.iotoms.com/api/v1/inventory/reservations/497f6eca-6276-4993-bfeb-53cbbbba6f08'
Example Response
{  "status": "string",  "message": "string",  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "itemId": "string",    "itemName": "string",    "quantity": 0,    "reservationType": "CART",    "referenceId": "8502eb05-558d-4480-8511-c1011710b340",    "customerId": "string",    "status": "ACTIVE",    "expiresAt": "2019-08-24T14:15:22Z",    "confirmedAt": "2019-08-24T14:15:22Z",    "releasedAt": "2019-08-24T14:15:22Z",    "releaseReason": "string",    "createdAt": "2019-08-24T14:15:22Z"  }}