Skip to main content
POST
Upload a feed file (HITL, multipart)

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

sourceId
string
required

Inventory source ID

Minimum string length: 1

Body

multipart/form-data

Multipart form-data body for POST /inventory-sources/:sourceId/feed/upload. Send the feed file as the file part and the remaining fields as form text fields. For deterministic replay, provide idempotencyKey, revisionId, and observedAt together; otherwise omit all three.

file
file
required

CSV, JSON, XLS, or XLSX file up to 10 MB. Provide as the file multipart part.

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
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

Upload a feed file (HITL, multipart)

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.