Skip to main content
POST
Preview a feed revision (HITL)

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

sourceId
string
required

Inventory source ID

Minimum string length: 1

Body

application/json

Request body for POST /inventory-sources/:sourceId/feed/preview.

contractId
enum<string>
required

Feed contract identifier. static-avails-feed:v1 for static avails CSV/JSON; wholesale-avails-pricing:v1 for wholesale pricing grids.

Available options:
static-avails-feed:v1,
wholesale-avails-pricing:v1
rawRows
object[]

JSON rows — provide exactly one of rawRows, csvText, or jsonText.

Minimum array length: 1
csvText
string

CSV text — provide exactly one of rawRows, csvText, or jsonText.

Required string length: 1 - 2000000
jsonText
string

JSON text — provide exactly one of rawRows, csvText, or jsonText.

Required string length: 1 - 2000000
idempotencyKey
string<uuid>

Deterministic replay idempotency key (UUID). Provide only together with revisionId and observedAt; omit all three fields for server-generated, non-retryable convenience values.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
revisionId
string<uuid>

Deterministic replay revision id (UUID). Provide only together with idempotencyKey and observedAt; omit all three fields for server-generated, non-retryable convenience values.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
observedAt
string<date-time>

ISO-8601 observation timestamp for deterministic replay. Provide only together with idempotencyKey and revisionId; omit all three fields to default to the current time.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

Response

Preview a feed revision (HITL)

Response from POST /feed/preview and POST /feed/upload. Pass previewBaseline and revision to POST /feed/commit.

feedId
string<uuid>
required

Canonical inventory feed id shared by all transports (HITL, API_PUSH) for this source and contract.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
sourceId
string
required

External source_id string for this feed.

revision
object
required

Inventory feed revision envelope returned by preview, upload, commit, and push endpoints. Matches the InventoryFeedRevisionSchema contract.

previewBaseline
object
required

Signed preview baseline. Pass it back unchanged to POST /feed/commit.