files_upload
Upload small files inline as standard base64 and receive signed_url, file_id and file metadata. purpose defaults to user-documents; mime_type defaults to application/octet-stream.
Effect: This call saves data or changes configuration. Review the behavior below before using it.
Inputs
filename
string
Required
Name of the uploaded file, including its extension.
content_base64
string
Required
Standard base64 of the complete file bytes.
purpose
string
Optional
Default user-documents. Allowed: user-documents, user-content, user-tables, form-banner.
mime_type
string
Optional
Content type. Default application/octet-stream.
Example
These are MCP tool arguments, not an HTTP request body. Replace bracketed IDs with values returned from your account.
{
"filename": "notes.txt",
"content_base64": "QXBwcm92ZWQgbm90ZXMu",
"mime_type": "text/plain"
}Result
Abbreviated result example; unshown fields are omitted for clarity.
Behavior
Each call creates a file.
The approximate limit is 200 KiB before base64 encoding.
The full JSON request must also fit within 256 KiB, so encoding overhead may lower the usable file size.
For files near this limit, use files_create_upload_url instead.
Troubleshooting
If the body exceeds the transport limit, use the large-file upload route. Base64 makes the request larger than the original file.
Related resources
Was this helpful?

