cURL
API Documentation
Upload file (temporary)
Upload a short-lived file for temporary staging.
POST
cURL
Utility endpoint — not org-scoped. Upload requires authentication; the response includes a download URL (~24h). Anyone with the URL can download until expiry — treat it as a secret. Not for sensitive or regulated data.
POST /orgs/{org_id}/k2/{kb_id}/files) instead.Authorizations
Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.
Body
multipart/form-data
Binary contents of the file. Max 100 MB.
Required range:
x >= 0Response
File uploaded
Short-lived upload metadata returned by POST /files.
Size of the uploaded payload in bytes.
MIME type as reported by the client.
Time the file was uploaded.
When the download URL is expected to stop working (~24h after upload).
Original filename (sanitized — slashes / control characters replaced).
Download URL. Anyone with this URL can fetch the file until it expires.