v2

latestOpenAPI 3.1.02026-08-07139158192.4 KB

Files

Mint a signed URL for a direct JSONL upload

For browser clients that upload the file straight to storage instead of through the API: returns a file id and a signed PUT URL (valid 15 minutes). After the PUT succeeds, register the file with the complete call. CLI and SDK clients should use the plain upload instead.

post/v1/files/presign

Request body

bytesinteger required

Exact size of the upcoming upload in bytes (max 200 MB).

filenamestring

Display name; not persisted.

Response

expires_atinteger required

Unix timestamp (seconds) the signed URL stops working.

file_idstring required

File id to register with the complete call after the PUT succeeds.

put_urlstring required

Signed URL; PUT the raw JSONL bytes to it.