Upload a file
upload_fileUpload a file to Karbon and attach it to a work item, contact, organization, or client group. Requires at least one key; prefer file path to avoid base64 size limits.
Instructions
Upload a file to Karbon and attach it to a work item, contact, organization, or client group (at least one key is required). SIZE LIMITS: keep uploads small — Karbon rejects oversized uploads, and this server reads the whole file into memory. Prefer filePath (a path on the machine running this MCP server) whenever possible; only use contentBase64 for small files (roughly under 1 MB), because base64 inflates data ~33% and large payloads can exceed the AI client's message limits or be truncated mid-transfer. If a file seems large (tens of MB or more), tell the user to upload it through Karbon's own UI instead. SECURITY: only upload files the user explicitly pointed you to. Never upload configuration files, credential stores, environment files, keys, or anything the user has not named — uploading puts the file's contents in the Karbon tenant.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fileName | No | File name including extension. Required with contentBase64; defaults to the filePath basename otherwise. | |
| filePath | No | Absolute path of the file on the machine running this MCP server (preferred) | |
| contactKey | No | ||
| workItemKey | No | ||
| contentBase64 | No | Base64-encoded file content — small files only; requires fileName | |
| clientGroupKey | No | ||
| organizationKey | No |