Skip to main content
POST
Upload File
Not available yet. The app-scoped Files API (/api/v1/files*) is not implemented — calls will 404. read_files / write_files are reserved scopes (requestable for forward-compat) with no endpoints bound yet. The shape below is the planned contract and may change.

Body Parameters

file
file
required
The file to upload (multipart/form-data)
alt
string
Alt text for the image (for accessibility)
folder
string
Optional folder path for organization

Supported File Types

TypeExtensionsMax Size
Imagesjpg, jpeg, png, gif, webp, svg20MB
Videosmp4, webm, mov100MB
Documentspdf, doc, docx10MB

Response

The planned contract returns the standard response envelope with the uploaded file under data.file.

Example Request