Docs: Tool reference
core toolset

create_upload

Start a file upload. Step 1 of attaching a file to a post, or of setting the workspace logo or favicon. Returns an attachment_id and a short-lived upload_url: send the file's bytes there with HTTP PUT and the returned headers (storage rejects any other size or type). Then pass the ID in create_post or update_post attachment_ids, or as logo_upload or favicon_upload in update_workspace_settings. Images (png, jpeg, gif, webp), pdf, txt, csv, mp4, webm and mov; at most 8 MB. Unattached uploads are discarded. Nobody is emailed.

Toolset
core
Who can call it
OwnersManagersContributorsCustomersAPI keys
REST
POST /api/v1/w/{workspace}/uploads
Behavior
changes dataaccepts idempotency_key

Input

FieldTypeDescription
filenamerequiredstring
content_typerequiredone of: image/png, image/jpeg, image/gif, image/webp, application/pdf, text/plain, text/csv, video/mp4, video/webm, video/quicktime
sizerequiredintegerExact size in bytes.
idempotency_keystringRetry-safe key. Repeating a call with the same key returns the first result.

Output

FieldTypeDescription
attachment_idrequiredstringID with prefix "att_"
upload_urlrequiredstring (uri)
upload_methodrequired"PUT"
upload_headersrequiredobjectSend exactly these headers.
expires_atrequiredstring (date-time)

Calling it

// MCP: tools/call
{ "name": "create_upload", "arguments": {"filename":"<string>","content_type":"<one of: image/png, image/jpeg, image/gif, image/webp, application/pdf, text/plain, text/csv, video/mp4, video/webm, video/quicktime>","size":"<integer>"} }

// Typed client
await carechannel.create_upload({"filename":"<string>","content_type":"<one of: image/png, image/jpeg, image/gif, image/webp, application/pdf, text/plain, text/csv, video/mp4, video/webm, video/quicktime>","size":"<integer>"});