Skip to main content
POST
Import a file

Authorizations

Authorization
string
header
required

nia_sk_...

Body

The body is of type string.

Response

202 - application/json

The file is stored and queued; follow it with GET /v1/ingest/files/{import_id}.

POST /v1/ingest/files answers 202 with this; GET /v1/ingest/files/{import_id} follows it.

accepted
integer
required
created_at
string<date-time>
required
duplicates
integer
required
errors
RowError · object[]
required

The first 100 rejected rows; values are never echoed.

format
enum<string>
required
Available options:
csv,
jsonl
import_id
string<uuid>
required
records
integer
required

Records in the file, blank lines included.

rejected
integer
required
sha256
string
required
size_bytes
integer
required
status
enum<string>
required
Available options:
queued,
running,
completed,
failed
finished_at
string<date-time> | null