Skip to main content
POST
Upload File
Maximum 32 MB per file on this endpoint. This single-shot POST /files endpoint sends the file body through the API server, which has a hard 32 MB inbound request size limit. Files larger than 32 MB are rejected before they reach the application layer.For files larger than 32 MB, use the v2 signed-upload flow instead. It uploads the file body directly from your client to Google Cloud Storage (the API server is not in the data path) and supports files up to 200 MB.

Supported files

Limits

  • Maximum file size per upload on this endpoint: 32 MB (platform inbound HTTP request size limit). For files up to 200 MB use the v2 signed-upload flow.
  • This endpoint accepts one file per request (use multiple requests for multiple files).
  • File storage limit: 30 files
  • Some features have different limits:
    • Chat attachments: up to 200 MB per file via the v2 signed-upload flow; up to 5 files per send
    • Audio transcription: up to 10 MB per file

Code Examples

Headers

integer
required
Workspace ID. Required as of 2026-09-01. Until then, if omitted, the user’s selected workspace is used (deprecated). After the cutoff, a missing header returns 422.

Response

Authorizations

Authorization
string
header
required

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

Headers

x-workspace-id
integer
required

Workspace ID. Required as of 2026-09-01. Until then, if omitted, the user's selected workspace is used (deprecated). After the cutoff, a missing header returns 422.

Body

multipart/form-data
file
file
required

The file to upload. Maximum size: 32 MB (platform inbound request size limit). Use the v2 signed-upload flow for files larger than 32 MB.

process
boolean
default:false

Whether to process the file after upload.

Response

200

File uploaded successfully.