Set how scans are read
Sets whether new scans are read with OCR as they arrive, and the languages OCR reads in.
$0.001 a call
From your agent’s balance. A call that fails costs nothing.
An example
Read every scan that comes in automatically, in German and English.
Your agent callsfiles_ocr_settings$0.001 a call
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.
{
"auto_ocr": true,
"languages": [
"deu",
"eng"
]
}Use it when
Scans come in often (receipts, delivery notes) and should be searchable without asking.
What it does
auto_ocr: read every new scan (an image, or a PDF without text) with OCR as it arrives, $0.005 a page, charged from the balance; a scan the balance can't cover stays unread and says why. Off by default: scans are then read when you ask (files_ocr). languages: the ones OCR reads in, up to 3 ([] goes back to the account's language: its website's, else its country's, else English). $0.001.
What comes back
The OCR settings: auto_ocr and the languages. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
auto_ocr | boolean | |
languages | array of strings | Up to 3 of eng, deu, fra, spa, ita, nld, por, swe. Up to 3 items. One of: eng,deu,fra,spa,ita,nld,por,swe. |
The call
Over MCP, call files_ocr_settings on https://api.conecto.chat/mcp/files. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/files_ocr_settings \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"auto_ocr":true,"languages":["deu","eng"]}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
invalid_input400 | A language is not one OCR reads here, or there are more than 3. | Use up to 3 of eng, deu, fra, spa, ita, nld, por, swe. |
invalid_input400 | Neither auto_ocr nor languages was given. | Send one of them. |
More Files tools
All 13 tools- Upload a file
files_uploadStores a file in the business's file store from its bytes, its text or a public link, with a download link.$0.001 a call - Get an upload link
files_upload_linkA one-time link to upload one file of up to 25 MB, to use yourself or hand to a person.Free - Find files
files_listThe business's files, newest first, filtered by name, words inside, tags, type, correspondent, document date or fields.Free* - Get a file
files_getOne file's details and a fresh download link, with the text of a small text file if asked.Free* - Read a file's words
files_read_textThe words in a file as Conecto read them: text files, PDFs, office files, HTML, and scans once read with OCR.Free* - Say what files are
files_editSays what one file is, or up to 100 at once: title, notes, document date, correspondent, type, tags and fields.$0.005 per file changed - Define a tag, type, field or correspondent
files_defineAdds, renames or deletes a tag, a document type, a custom field or a correspondent to file things with.$0.001 a call - List tags, types, fields and correspondents
files_definitionsThe tags, document types, custom fields and correspondents the business files with, each with how many files use it, and the OCR settings.Free*
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md