# Add or update an item — Botize's databases

Botize method — `btzlistpku.put_item` (action).

Add a new item to a database or update it if it already exists, avoiding the creation of duplicates.

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.

- `mb_switch` *(boolean)* — Rules
- `container_name` *(string)* — Database
- `s_pk` *(string)* — Index

It also accepts repeatable field groups, with these prefixes: `mb_filters_*`, `field_counter_*`, `field_name_*`, `field_type_*`, `field_value_*`. These are composite components (buttons, filters, keyboards); the trailing number is set by the user as they are added.

## Output variables

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

- `{{operation}}` *(text)* — Operation. Result of the operation performed. The value is 'INSERT' if the item did not exist in the database and was therefore added, or 'UPDATE' if the item already existed and was updated.
For example: INSERT
- `{{has_item_been_added}}` *(boolean)* — Has Item Been Added. Indicates that the item has been added to the database.
For example: true
- `{{has_item_been_updated}}` *(boolean)* — Has Item Been Updated. Indicates that the item has been updated in the database.
For example: true

## This app

Every trigger and action for Botize's databases: https://botize.com/en/app/btzlistpku.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/btzlistpku/put_item