# Add a document — Vector database

Botize method — `btzvectors.add_document` (action).

Stores a text in a database so it can later be found by meaning. If the key already exists the document is replaced, never duplicated.

This is an action: it runs as a step of a task. Several can be chained.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `base` *(string)* — Database name
- `text` *(string)* — Text
- `doc_key` *(string)* — Document key (optional)
- `meta` *(string)* — Metadata (optional)

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{doc_key}}` *(text)* — Document key. The key the document was stored under
- `{{base}}` *(text)* — Database. Name of the database used
- `{{replaced}}` *(boolean)* — Replaced an existing one. 1 if a document with the same key already existed
- `{{documents}}` *(int)* — Documents in the database. How many documents the database holds now
- `{{remaining}}` *(int)* — Remaining capacity. How many more documents fit before reaching the limit

## This app

Every trigger and action for Vector database: https://botize.com/en/app/btzvectors.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/btzvectors/add_document