Skip to main content
POST
cURL

Uploading the file

PUT the file’s bytes to the URL in filenameToSignedUrl. Send no Authorization header on that request — the URL carries its own signature, and it expires after an hour. Then call Validate an upload with the uploadSession.name from this response.

Authorizations

Authorization
string
header
required

Authorization: Bearer <your API key> -- the same key as inference. A key reaches the account it belongs to and no other.

Path Parameters

account
string
required

Your account id -- the one in the console's address bar (my-account for this key). It must be the account the key belongs to.

Maximum string length: 64
dataset
string
required

The dataset's id, as chosen when it was created.

Maximum string length: 64

Body

application/json
filenameToSize
object
required

The one file this version consists of, mapped to its size in bytes. A version is exactly one JSON Lines file, of at most 1 GiB; a larger one is refused before any URL is issued (DATASET_TOO_LARGE).

resumable
boolean

Accepted for compatibility; uploads are a single PUT either way.

Response

OK.

uploadSession
object
filenameToSignedUrl
object
version
object