Upload a margin file

post

https://sandbox.api.javis.ai/v1/imports

Accepts a margin multipart upload with a file and optional metadata JSON part.

Body Params

file

required

The file to upload. Supported: XLSX, CSV, TXT, ZIP/GZIP containing a single file, and generic application/octet-stream.

metadata

object

Optional metadata controlling parsing and routing. For large-file flows, upload via pre-signed URL and reference it via source.objectKey (omit the file part).

Headers

Client-Id

integer

required

Tenant/client identifier used for routing and authorization.

File-Type

string

enum

required

Semantic type of the uploaded file. See enum for allowed values.

File-Variant

string

Only when File-Type is 'MARGINS','EXCLUSION' etc. Declares the business variant/layout the rows apply to.

Profile-Id

string

Explicit parser profile to apply (column mapping, formats, sheet name for XLSX, key schema, etc.). If omitted, the server may resolve a profile from (Client-Id, File-Type, File-Variant).

Idempotency-Key

string

length ≤ 128

(RECOMMENDED). Unique key (e.g., UUID) to safely retry the same request. If a request with the same key was already processed, the server returns the original result.

Content-Digest

string

(RECOMMENDED). HTTP message integrity for the request payload. Use 'sha-256' with a base64 value. Example: 'sha-256=:BASE64DIGEST:'. Validates that bytes received match what the client sent.

Text-Encoding

string

Defaults to utf-8

Character encoding for text files. Defaults to 'utf-8'. Not to be confused with HTTP Content-Encoding.

Delimiter

string

length between 1 and 8

Field separator for delimited text files (CSV, TSV, TXT). Defaults to ',' (CSV). For TSV use '\t'; for pipe-delimited use '|'.

Has-Header

string

enum

Defaults to true

Whether the first row of a CSV/TSV file is a header row. Defaults to true.

Allowed:

202Accepted; import created and queued

400Invalid request (e.g., missing file, invalid header combinations)

409Idempotency conflict or incompatible headers (e.g., File-Type vs File-Variant)

500Internal Server Error