files

Changed on

Upload a short-lived file for temporary staging.

post/files

Request

  • Base URL
    https://api.timbal.ai
  • URL
    https://api.timbal.ai/files
  • Auth
    HTTP bearer

Request body multipart/form-data

fileinteger[] required

Binary contents of the file. Max 100 MB.

Response

File uploaded

content_lengthinteger required

Size of the uploaded payload in bytes.

content_typestring required

MIME type as reported by the client.

created_atstring date-time required

Time the file was uploaded.

expires_atstring date-time required

When the download URL is expected to stop working (~24h after upload).

namestring required

Original filename (sanitized — slashes / control characters replaced).

urlstring required

Download URL. Anyone with this URL can fetch the file until it expires.

Changes