Refillo API

Stop reordering a list of products

Up to 500 product-shops in one request. The same write as Stop reordering on the product page.

The two states

phasing_out means sell what is left and order no more. stopped means order nothing, including what is left on the way. active means order again. Send a note if you want it on the product's log. The person recorded is the key's prefix and whoever created the key.

Find the ids

GET /v1/products returns each product's id and, under locations, the location_id. Use those uuids. A made-up id comes back as not_found for that item and the others still apply.

The request

One Idempotency-Key for the whole list. Retrying with the same key and the same body returns the first answer and does not apply twice.

curl -sS -X PUT https://app.refilloapp.com/api/v1/products/handling \
  -H "Authorization: Bearer $REFILLO_API_KEY" \
  -H "Idempotency-Key: stop-season-2026-10-06" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"product_id":"00000000-0000-4000-8000-0000000000aa","location_id":"00000000-0000-4000-8000-0000000000bb","state":"phasing_out"}]}'