Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

A Liquid API key from the API keys page of Liquid Console, sent as Authorization: Bearer $LIQUID_API_KEY.

Body

application/json
purpose
string
required

Must be "batch".

filename
string
required

The file name (max 255 characters).

bytes
integer
required

The file size in bytes. Rejected up front if over the 200 MB limit.

mime_type
string

Content type of the upload. Defaults to application/jsonl.

Response

200 - application/json

Successful response.

id
string

The file id, referenced when creating a batch.

object
string

Always "file".

bytes
integer

Size of the file in bytes.

created_at
integer

Unix timestamp (seconds) of creation.

filename
string

The name the file was uploaded with.

purpose
string

Either "batch" (an input) or "batch_output" (a generated result/error file).

status
string

Always "processed"; stored files are ready.

expires_at
integer

Unix timestamp (seconds) when the file expires, if set.

upload_url
string

A short-lived presigned URL. PUT the file bytes here.

upload_expires_at
integer

Unix timestamp (seconds) when the upload URL expires.