Request Presigned Upload
const url = 'https://example.com/ingest/upload/presigned';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"content_type":"application/octet-stream","file_size":1,"filename":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/ingest/upload/presigned \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "content_type": "application/octet-stream", "file_size": 1, "filename": "example" }'Request presigned URL(s) for direct-to-S3 file upload.
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ”object
MIME type to associate with the uploaded object.
Total file size in bytes. Used to decide between single-part and multipart upload.
Original filename being uploaded. Used to determine the file extension and content disposition.
Responses
Section titled “ Responses ”Successful Response
object
Identifier of the ingestion job created for this upload.
Object key in the S3 bucket where the file will be stored.
One presigned PUT URL per part. Single-element list for single-part uploads.
Example generated
{ "job_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "part_size": 1, "s3_key": "example", "upload_id": "example", "urls": [ "example" ]}Bad request — invalid payload
Unauthorized — missing or invalid credentials
Forbidden — caller lacks write access
Not found
Conflict — resource state prevents the operation
Payload too large
Validation error
Too many requests — retry after the advertised interval
Headers
Section titled “Headers ”Seconds until the request may be retried
Internal server error
Bad gateway — an upstream provider failed
Service unavailable — the database could not serve the request