Skip to content

Trigger Offer Refresh

Request

Trigger an asynchronous fetch of fresh offers from the configured external supplier APIs (Octopart, TrustedParts, distributor APIs, ...) for the given off-the-shelf parts.

This is asynchronous: the endpoint responds 202 Accepted and the freshly fetched offers are written in the background. Poll the offer-lookup endpoints afterwards to read them.

Security
BearerAuth
Headers
Acceptstring(OfferAcceptHeader)required

Set this to application/api.luminovo.offer-v1+json.

Value:"application/api.luminovo.offer-v1+json"
Bodyapplication/jsonrequired
partsArray of stringsrequired

Off-the-shelf part IDs to refresh offers for. Each is an opaque colon-separated string of the form OffTheShelf:<uuid> (e.g. OffTheShelf:a1b2c3d4-5678-90ab-cdef-123456789012).

Example:
[
  "OffTheShelf:a1b2c3d4-5678-90ab-cdef-123456789012"
]
POST
/offers/refresh
curl -i -X POST \
  https://api.luminovo.com/offers/refresh \
  -H 'Accept: application/api.luminovo.offer-v1+json' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "parts": [
      "OffTheShelf:a1b2c3d4-5678-90ab-cdef-123456789012"
    ]
  }'

Responses

Update accepted (no body). Offers are fetched from the configured supplier APIs asynchronously and become available via the offer-lookup endpoints (POST /offers/find, POST /offers/bulk, GET /offers/{id}) once ready. Part ids that don't resolve are silently ignored.