Files

Get an upload link

files_upload_link · Changes data · Markdown

A one-time link to upload one file of up to 25 MB, to use yourself or hand to a person.

Free

This tool costs nothing to call.

An example

Send Rachel a link so she can upload the insurance form for her crash repair.

Your agent callsfiles_upload_linkFree

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{
  "name": "Insurance form, Rachel Kim.pdf",
  "content_type": "application/pdf"
}
What comes back
{
  "upload_url": "https://api.conecto.chat/v1/files/upload/.eJwlzUsOwiAUheGtkDsGLag8uoPGmTu4XCASW0r6iCbGvUt0cgZ_vuS84Qm95PD4bYIePCnnUUWBWgdx9kEKe1JBONspE73T7kLAoTQ6lHVfsFBkaV4mzm5I9ziya54ONaSGtoaw1jETbnkux3-Nr9rejFOdMdrKzxd4cCXn:1xHMKf:EA40cTWX4K-dO5DqYcaNi0VRKnY9dt83tc37jFX2AjQ",
  "method": "PUT",
  "file_id": "bc29ba2e-a66d-4bd1-832d-98027eb9695c",
  "expires_in_minutes": 60,
  "how": "curl -T <path-to-file> \"https://api.conecto.chat/v1/files/upload/.eJwlzUsOwiAUheGtkDsGLag8uoPGmTu4XCASW0r6iCbGvUt0cgZ_vuS84Qm95PD4bYIePCnnUUWBWgdx9kEKe1JBONspE73T7kLAoTQ6lHVfsFBkaV4mzm5I9ziya54ONaSGtoaw1jETbnkux3-Nr9rejFOdMdrKzxd4cCXn:1xHMKf:EA40cTWX4K-dO5DqYcaNi0VRKnY9dt83tc37jFX2AjQ\"",
  "max_size": "25 MB"
}

Use it when

A file is too big to send inline, or a person should send the business a document.

What it does

A one-time link to upload one file of up to 25 MB as the raw request body, e.g. `curl -T report.pdf "<upload_url>"` (PUT). Works for an hour. Free to ask for; the upload itself costs $0.001 when it arrives and replies with the file and its download link. Hand it to a person to send you a document: files.added tells you when it arrives, with its text once read.

What comes back

upload_url and method (PUT), the file_id the file will have, how many minutes the link works, and how to use it. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
nameRequiredstring1 to 200 characters.
content_typestringUp to 120 characters.

The call

Over MCP, call files_upload_link on https://api.conecto.chat/mcp/files. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/files_upload_link \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Insurance form, Rachel Kim.pdf","content_type":"application/pdf"}'

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md