For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

Name
Type
Requirement
Description

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.

File uploads

Connection, permissions, pagination, and recovery

Was this helpful?