conecto. Get started
Files

List tags, types, fields and correspondents

files_definitions · Reads only · Markdown

The tags, document types, custom fields and correspondents the business files with, each with how many files use it, and the OCR settings.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

How do we file documents now? Which tags and types do we have?

Your agent callsfiles_definitionsFree*

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
{}
What comes back
{
  "tags": [
    {
      "name": "tax 2026",
      "files": 1
    }
  ],
  "document_types": [
    {
      "name": "Invoice",
      "files": 1
    }
  ],
  "fields": [
    {
      "name": "Total",
      "field_type": "money",
      "currency": "USD",
      "files": 1
    }
  ],
  "correspondents": [
    {
      "name": "Cascade Bike Supply",
      "company_id": null,
      "contact_id": null,
      "files": 1
    }
  ],
  "correspondents_total": 1,
  "ocr": {
    "auto_ocr": false,
    "languages": [
      "eng"
    ],
    "languages_chosen": false,
    "available": true,
    "price_per_page": "$0.005",
    "languages_supported": [
      "eng",
      "deu"
    ]
  }
}

Use it when

Before filing, to reuse the names that exist.

What it does

Everything the account defined to file things, each with how many files use it: tags, document types, custom fields (with their type), correspondents (with their CRM links), and how scans are read (auto-OCR, languages).

What comes back

tags, document_types, fields (with their type) and correspondents (with their CRM links), each with how many files use it; and how scans are read. Every reply also carries cost_usd and balance_usd.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/files_definitions \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

More Files tools

All 13 tools

Give this to your agent.

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