Skip to main content
PUT
/
documents
/
v2
/
files
cURL
curl --request PUT \
  --url https://api.tensorlake.ai/documents/v2/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file_bytes='@example-file' \
  --form 'labels={
  "owner": "JohnDoe",
  "project": "Tensorlake"
}'
{
  "file_id": "file_12345",
  "created_at": "2023-10-01T12:00:00Z"
}
This operation allows you to upload a file to the Tensorlake Cloud. The file will be associated with the project specified by the API key used in the request. The file can be of any of the following types:
  • PDF
  • Word (DOCX)
  • Spreadsheets (XLS, XLSX, XSLM, CSV)
  • Presentations (PPTX, Apple Keynote)
  • Images (PNG, JPG, JPEG)
  • Raw text (plain text, HTML)
The file type is automatically detected based on Content-Type header. In case the Content-Type header is not provided, the file extension will be used to infer the type. If the file type cannot be determined, it will default to application/octet-stream. We only keep one copy of the file, so uploading the same file multiple times will return the same file_id.

​
Labels

Labels can be added to the file to help categorize the parse jobs associated with it. Labels are key-value pairs that can be used to filter and organize files. These should be provided in the a labels text field in the multipart form data. Labels are optional, but they can be very useful for organizing and managing parse jobs.

​
Limits

There is an upload limit of 1 GB per file. If you need to upload larger files, please reach out to us at [email protected].

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data
​
file_bytes
file
required

Binary contents of the file to upload

​
labels
object

Optional key‑value labels such as owner=JohnDoe or {"owner":"JohnDoe","project":"Tensorlake"}. Each label goes in its own form‑data part.

Example:
{
  "owner": "JohnDoe",
  "project": "Tensorlake"
}

Response

File uploaded successfully

​
file_id
string
required

The ID of the created file

Use this ID to reference the file in parse, datasets, and other operations.

Example:

"file_12345"

​
created_at
string
required

The creation date and time of the file.

This is in RFC 3339 format.

Example:

"2023-10-01T12:00:00Z"