---
name: "files_definitions"
area: "files"
title: "List tags, types, fields and correspondents"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/files_definitions"
mcp_server: "https://api.conecto.chat/mcp/files"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/files/files_definitions"
---

# List tags, types, fields and correspondents (`files_definitions`)

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

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).

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

Before filing, to reuse the names that exist.

## Say this to your agent

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

## Inputs

This tool takes no arguments: send `{}`.

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `files_definitions` on the MCP server `https://api.conecto.chat/mcp/files` with these arguments:

```json
{}
```

REST:

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

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "files_definitions",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "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"
      ]
    }
  }
}
```

`result`: 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.

## Errors

This tool has no errors of its own.

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [files_upload](https://conecto.chat/tools/files/files_upload.md): Stores 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.
- [files_upload_link](https://conecto.chat/tools/files/files_upload_link.md): A one-time link to upload one file of up to 25 MB, to use yourself or hand to a person. Free.
- [files_list](https://conecto.chat/tools/files/files_list.md): The business's files, newest first, filtered by name, words inside, tags, type, correspondent, document date or fields. Free up to 1,000,000 reads a month.
- [files_get](https://conecto.chat/tools/files/files_get.md): One file's details and a fresh download link, with the text of a small text file if asked. Free up to 1,000,000 reads a month.
- [files_read_text](https://conecto.chat/tools/files/files_read_text.md): The words in a file as Conecto read them: text files, PDFs, office files, HTML, and scans once read with OCR. Free up to 1,000,000 reads a month.
- [files_edit](https://conecto.chat/tools/files/files_edit.md): Says what one file is, or up to 100 at once: title, notes, document date, correspondent, type, tags and fields. $0.005 per file changed.
- [files_define](https://conecto.chat/tools/files/files_define.md): Adds, renames or deletes a tag, a document type, a custom field or a correspondent to file things with. $0.001 a call.
- [files_ocr](https://conecto.chat/tools/files/files_ocr.md): Reads the words in a scan with OCR: an image, or the pages of a PDF without text; the text is kept. $0.005 per page read.
- [files_ocr_settings](https://conecto.chat/tools/files/files_ocr_settings.md): Sets whether new scans are read with OCR as they arrive, and the languages OCR reads in. $0.001 a call.
- [files_delete](https://conecto.chat/tools/files/files_delete.md): Deletes a file for good; every download link to it stops working. Free.
- [files_add_storage](https://conecto.chat/tools/files/files_add_storage.md): Rents 10 GB more file storage, renewed monthly from the balance; this call pays the first month. $1.00 a call.
- [files_remove_storage](https://conecto.chat/tools/files/files_remove_storage.md): Stops renting one 10 GB block of storage, if the files still fit. Free.