Sports Inventory

Update Records

Updates only the top-level fields supplied for an existing entity; omitted top-level fields remain unchanged.

  • PUT does not create a missing row. Acceptance is asynchronous, so a PUT for an unknown key still receives 202 — ensure the entity was created first.
  • Nested objects replace rather than merge: a supplied object field (for example categoryNameTranslated or extra) replaces the stored object entirely. Retain your authoritative object before sending an update meant to preserve existing nested keys.
  • Safe odds updates: automatic decimal-price derivation is not guaranteed on PUT. When fractional odds change, send numPrice, denPrice, and decPrice together with consistent values; to mark a Selection unpriced, set all three to null. Never update only one of the fractional pair.
  • Record expiry — the optional X-Expires-After header applies a relative expiry (integer seconds, minimum 60) to every record in the request. PUT without the header preserves any existing expiry; to remove an expiry, send a complete authoritative POST for the row without the header.
put/records

Request

  • Base URL
    https://api.opti-x.optimove.net/sports-inventory/v1
  • URL
    https://api.opti-x.optimove.net/sports-inventory/v1/records
  • Auth
    API key in header x-api-key

Headers

x-api-keystring required

Your API key for authentication

x-brand-keystring required

The brand key identifying which brand this data belongs to

X-Expires-Afterinteger

TTL in seconds; minimum 60

Request body

Response

Accepted request

successboolean

Have all records been accepted successfully. If false, some or all records may not have been recorded

Changes

No recorded changes to this operation across all 1 revision of this API.