> ## Documentation Index
> Fetch the complete documentation index at: https://docs.riggery.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# State upsert

> Записать JSON-записи Instance по ключу.

Пишет JSON-записи по ключу. Для пакета лучше JSON предыдущего узла `{ collection, items: [{ key, data }] }`. **Коллекция** / **Ключ (необязательно, одна запись)** — запасной вариант для одной строки.

<h2 id="input">
  Вход
</h2>

Вкладка инспектора **Настройки**. Правила пустого поля на графе: [Предыдущие узлы](/ru/graph/previous-nodes). **Вставить значение** здесь нет.

У инструмента на агенте оба могут быть **Решает агент** или **Фиксировано**.

Пустые поля не выдумывают записи. Нет items — шаг падает: передайте JSON `{ collection, items: [{ key, data }] }` с предыдущего узла или заполните коллекцию и ключ.

| Поле                                  | Обязательно | Пустое | Заметки                                                     |
| ------------------------------------- | ----------- | ------ | ----------------------------------------------------------- |
| **Коллекция**                         | Нет         | —      | Нужна, если в JSON предыдущего Result ещё нет `collection`. |
| **Ключ (необязательно, одна запись)** | Нет         | —      | Одна строка, если предыдущий Result не пакет.               |

<h2 id="output">
  Выход
</h2>

На следующем узле **Предыдущие узлы** показывает **`State upsert`: Result** (`{{State upsert.text}}`, пока имя уникально).

| Выход  | В меню | Тип   | Следующий узел получит                                                                                                                            |
| ------ | ------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| Result | Да     | Текст | Строка статуса вроде `Upserted 3 record(s) into "rates".` Не сами записи. Конфликт предиката возвращает `conflict: …` как Result (шаг не падает). |
