anythink-cloud/anythink-cli

Создаёт новый биллинговый аккаунт (организацию) для хранения проектов и платёжных данных. Требует предварительного входа на платформу (сначала воспользуйтесь инструментом 'login'). Новый аккаунт автоматически становится активным, поэтому последующие вызовы 'projects_create' / 'projects_list' будут обращаться к нему без дополнительной настройки. Возвращает id и имя нового аккаунта. Большинству пользователей нужен только один аккаунт, поэтому сначала вызовите 'accounts_list' и проверьте, нет ли уже подходящего.

Перечисляет платёжные аккаунты (организации), к которым принадлежит пользователь, вошедший в систему. Требует предварительного входа на платформу (сначала вызовите инструмент 'login'). Возвращает id каждого аккаунта, название организации, email для выставления счетов, валюту и статус (Active/Suspended/Canceled), а также отмечает, какой из них сейчас активен. Платёжный аккаунт хранит ваши проекты и платёжные данные. Выберите один из них с помощью 'accounts_use' прежде чем создавать проекты или выводить их список.

Устанавливает активный платёжный аккаунт, с которым работают команды проектов. Вызывайте его после 'login', если у вас больше одного аккаунта, перед использованием 'projects_list', 'projects_create' или 'projects_use'. Принимает полный UUID аккаунта или уникальный префикс; запустите 'accounts_list', чтобы увидеть допустимые id. Возвращает имя и id найденного аккаунта или ошибку, если ни один аккаунт не совпадает.

Перечисляет все эндпоинты API (маршруты платформы + динамически создаваемые маршруты сущностей). Перечисляет полные URL для фиксированного набора основных маршрутов (авторизация, ключи API, сущности, поля, рабочие процессы), пяти CRUD-маршрутов каждой сущности в проекте, а также публичных маршрутов для публичных сущностей и маршрута каждого рабочего процесса, запускаемого через API. Используйте его, чтобы выдавать разработчикам приложений URL эндпоинтов; чтобы вызвать эндпоинт, используйте fetch. Возвращает JSON.

Создаёт API-ключ. Сам ключ показывается один раз, и его больше нельзя получить. Создаёт проектный API-ключ с указанными разрешениями (имена берутся из fetch по /permissions), срок действия которого истекает через 1-365 дней, по умолчанию через 90. Разрешения, которых у вас нет, отбрасываются с предупреждением. Сам ключ появляется только в этом выводе или сразу попадает в профиль CLI с save_as, так что сохраните его сразу. Возвращает JSON.

Выводит список API-ключей текущего пользователя. Показывает id, имя, число разрешений, дату истечения и статус каждого ключа: активен, истёк или отозван; сами значения ключей никогда не возвращаются. Используйте id вместе с api_keys_revoke.

Отзывает API-ключ по ID. Отзывает ключ немедленно и навсегда, поэтому любой скрипт, CI-задача или профиль CLI, которые его используют, перестают аутентифицироваться. Сначала создайте замену с помощью api_keys_create, если что-то ещё нуждается в доступе. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Создаёт диаграмму. Сначала проверяет её с помощью charts preview. Сохраняет диаграмму, которая отображает записи сущности, метрику использования платформы (см. charts_platform_metrics) или квоту плана. Сначала проверяет настройки и отклоняет вызов, перечислив проблемы. Новая диаграмма нигде не отображается, пока вы не поместите её на дашборд с помощью dashboards_add_chart или dashboards_create. Возвращает JSON.

Удаляет график. Дашборды, которые его показывают, оставляют пустой виджет, пока вы его не удалите. Безвозвратно удаляет сохранённый график из проекта. Чтобы убрать график с одного дашборда, но сохранить его, вместо этого используйте dashboards_remove_widget. После удаления найдите виджеты, которые его показывали, с помощью dashboards_get и очистите их с помощью dashboards_remove_widget. Возвращает JSON. Изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Получает полную конфигурацию диаграммы. Показывает все настройки одной сохранённой диаграммы: тип, источник данных, сущность или метрику, группировку, меру и агрегацию, фильтры, временное окно, цель и сравнение. Прочитайте её перед charts_update; чтобы увидеть данные, которые она отрисовывает, используйте dashboards_widget_preview с типом chart и её id. Возвращает JSON.

Перечисляет графики, сначала новые. Показывает id, имя, тип, источник данных каждого сохранённого графика, сущность или метрику, которую он отображает, и когда он последний раз менялся; передайте entity, чтобы увидеть графики только одной сущности. График сохраняется сам по себе и появляется на дашборде только после добавления через dashboards_add_chart. Возвращает JSON.

Перечисляет метрики использования, которые может построить график с источником platform. Показывает каждую метрику использования проекта, которую может построить график с источником platform: её id, label, shape, поддерживаемые типы графиков и разбивки. Передаёт id метрики как platform_metric в charts_preview или charts_create, а одну из её разбивок как stack_by. Возвращает JSON.

Показывает данные, которые нарисует конфигурация графика, не сохраняя её. Запускает конфигурацию графика на текущих данных проекта и показывает точки, итоги или строки, которые она построит, обрезанные до строк. Используйте его, чтобы определить сущность, группировку, меру и фильтры перед charts_create или charts_update; для уже сохранённого графика используйте dashboards_widget_preview. Возвращает JSON.

Изменяет диаграмму. Меняются только те настройки, которые вы передаёте; остальные остаются как были. Сохраняет новые настройки в существующей диаграмме; фильтр заменяет все её существующие фильтры. Виджеты дашборда ссылаются на диаграмму, а не копируют её, поэтому каждый дашборд, который её показывает, отрисовывает новую версию. Сначала вызовите charts_get, чтобы посмотреть её текущие настройки. Возвращает JSON. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Запускает любую команду Anythink CLI и возвращает её вывод. Предпочитает специализированные инструменты; используется для всего, что они не охватывают. Передаёт команду точно так, как её вводят после 'anythink', например 'entities list' или 'data list posts'. Деструктивные команды pay (delete, expire, relink, pause и подобные) должен запускать человек в терминале; никогда не добавляет '--yes' от имени пользователя. 'data import' создаёт записи (не деструктивная): сначала запускает её с --dry-run и добавляет '--yes' только после того, как пользователь одобрит пробный запуск. 'import directus' изменяет проект: сначала запускает её с '--dry-run' и добавляет '--yes' только после того, как пользователь одобрит план. Добавляет '--json' там, где поддерживается, для машиночитаемого вывода.

Удаляет сохранённый профиль проекта из локальной конфигурации CLI. Удаляет только локально сохранённые учётные данные и настройки - не удаляет проект и не отзывает токены на стороне сервера (чтобы удалить сам проект, используйте 'projects_delete'). Чтобы увидеть имена профилей, запустите 'config_show'. Возвращает подтверждение или сообщение о том, что профиль не найден.

Показывает локальную конфигурацию CLI: все сохранённые профили проектов и входы в платформы, а также какой из них активен. Для каждого профиля возвращает имя, идентификатор организации, способ аутентификации (api-key или token), псевдоним и платформу; для каждой платформы возвращает URL-адреса, платёжный аккаунт и статус входа. Используйте это, чтобы узнать имена профилей для 'config_use', 'config_remove' или 'logout' и проверить, на какой проект сейчас нацелен инструмент 'cli'. Читает только локальную конфигурацию, сетевые вызовы не делает.

Переключает активный профиль проекта, с которым работают команды инструмента 'cli'. Так можно переключаться между уже подключёнными проектами без повторной аутентификации. Профиль должен уже существовать (создан через 'projects_use' или 'login_direct'); имена доступных профилей показывает 'config_show'. Возвращает подтверждение или ошибку, если профиль не существует.

Добавляет диаграмму на дашборд как новый виджет. Всё остальное на дашборде остаётся как было. Так сохранённая диаграмма попадает на дашборд. Виджет берёт имя диаграммы в качестве заголовка, если не задан title, и встаёт после существующих виджетов, если column, row, width или height не задают его положение на 12-колоночной сетке. Сначала создайте диаграмму с помощью charts_create; не используйте для этого dashboards_update, потому что он заменяет все виджеты. Возвращает JSON.

Создаёт дашборд, при желании сразу с графиками. Создаёт новый дашборд, принадлежащий вам; виден только вам, пока не задан shared. Каждый переданный id графика становится виджетом графика с заголовком по имени графика; добавить ещё можно позже с помощью dashboards_add_chart. Сначала нужно создать графики с помощью charts_create. Чтобы сделать его дашбордом проекта по умолчанию, нужны права администратора. Возвращает JSON.

Получает данные, лежащие в основе виджетов дашборда. Запускает виджеты сохранённого дашборда или только переданные ID виджетов и показывает для каждого ID, заголовок, тип и текущие данные, обрезанные до указанного числа строк на виджет. Используйте его, чтобы прочитать, что дашборд показывает сейчас; используйте dashboards_widget_preview, чтобы попробовать виджет, которого ещё нет на дашборде. Возвращает JSON.

Удаляет дашборд и его виджеты. Графики на нём сохраняются. Удаляет дашборд для всех, кто может его видеть. Чтобы убрать один график с дашборда, используйте dashboards_remove_widget; чтобы удалить сам график, используйте charts_delete. Если это был ваш домашний дашборд, dashboards_mine откатывается к проекту по умолчанию. Возвращает JSON. Изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Получает дашборд с его виджетами и их позициями. Показывает название дашборда, описание, настройки общего доступа, владельца, а также id, тип, заголовок каждого виджета, график, который он отображает, и его позицию в сетке. Помогает найти id виджетов для dashboards_remove_widget и dashboards_data, а также посмотреть текущие виджеты перед dashboards_update. Возвращает JSON.

Перечисляет дашборды, которые вы видите. Показывает id, имя, владельца каждого дашборда и то, ваш ли это домашний дашборд, дашборд проекта по умолчанию или общий. Дашборд - сетка виджетов, большинство из них показывают сохранённый график; откройте один с помощью dashboards_get, чтобы увидеть его виджеты, или dashboards_mine для того, на который вы попадаете. Возвращает JSON.

Получает ваш стартовый дашборд или дашборд проекта по умолчанию, если у вас его нет. Показывает те же подробности, что и dashboards_get, для дашборда, который вы видите первым, когда открываете проект. Применяется, когда у вас нет идентификатора дашборда; дашборд, на который вы попадаете, меняется с помощью dashboards_set_home. Возвращает JSON.

Копирует панель поверх стандартной панели проекта, с которой начинают новые пользователи (только для администраторов). Перезаписывает стандартную панель проекта копией этой. Стандартная панель - то, с чего начинают новые пользователи и куда попадает любой, у кого нет домашней панели; панель, из которой вы копируете, остаётся как была. Чтобы изменить только свою стартовую панель, используйте dashboards_set_home. Возвращает JSON. Изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Удаляет виджет с дашборда. Всё остальное на дашборде остаётся как было. Снимает виджет с дашборда и убирает из его раскладки; график, который он показывал, сохраняется, и его можно вернуть с помощью dashboards_add_chart. Получает идентификаторы виджетов из dashboards_get. Используйте charts_delete только чтобы полностью удалить график из проекта. Возвращает JSON. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Делает вашу панель стартовой панелью. Меняет только вашу собственную стартовую панель, заменяя вашу предыдущую домашнюю; других пользователей это не затрагивает. Проверьте результат с помощью dashboards_mine. Чтобы изменить, с чего начинают новые пользователи, используйте dashboards_promote_to_default. Возвращает JSON. Меняет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Переименовывает дашборд, меняет, кто может его видеть, или заменяет его виджеты и раскладку. Меняет имя, описание или общий доступ к дашборду либо заменяет весь список виджетов и раскладку через config; виджеты, отсутствующие в новом списке, удаляются. Чтобы добавить или удалить один график, используйте dashboards_add_chart или dashboards_remove_widget, они сохраняют всё остальное. Только владелец может менять общий доступ. Возвращает JSON. Изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Показывает данные, которые виджет отрисовал бы, без сохранения. Работает для сохранённого графика, если указан его id, а также для списка, материализованного представления, markdown и других виджетов, если указана их конфигурация. Используйте его, чтобы увидеть, что сохранённый график показывает сейчас, или попробовать виджет перед добавлением через dashboards_add_chart или dashboards_update; для виджетов, уже добавленных на дашборд, используйте dashboards_data. Возвращает JSON.

Создаёт новую запись. Вставляет одну запись из JSON-объекта с именами полей и значениями и возвращает созданную запись с её новым id. Объекты или массивы, переданные для полей jsonb, автоматически отправляются как JSON-строки. Рабочие процессы с триггером EntityCreated для этой сущности запустятся. Чтобы загрузить много строк из файла, используйте data_import.

Удаляет запись. Удаляет одну запись по её числовому id. Записи в других сущностях, которые ссылаются на неё через поле связи, подчиняются правилу on-delete этого поля; при значении по умолчанию, CASCADE, они тоже удаляются. Запустятся рабочие процессы с триггером EntityDeleted на этой сущности. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Экспортирует записи в файл CSV, JSON или JSONL (потоком, страница за страницей). Записывает каждую подходящую запись в файл на машине, где запущен CLI, или в стандартный вывод, если файл указан как -, забирая данные страница за страницей. Использует тот же синтаксис фильтров, что и data_list; поля с отношением «один ко многим» опускаются, если их не указать в списке полей. Не перезаписывает существующий файл, если не включить принудительную перезапись. Для одной страницы записей используйте data_list.

Получает одну запись по ID. Возвращает все значения полей одной записи по её числовому id. Использует data_list с фильтром, когда id неизвестен, search_query, чтобы найти её по тексту, и data_rls, чтобы увидеть, какие пользователи имеют к ней доступ.

Создаёт записи из CSV, массива JSON или файла JSONL. Всегда сначала запускайте с --dry-run и добавляйте --yes только после одобрения пробного запуска. Читает файл на машине, где выполняется CLI, и создаёт по одной новой записи на строку, сверяя значения с типами полей сущности; строки с неизвестными столбцами отклоняются, если не указано их игнорировать. Системные столбцы, такие как id, игнорируются, поэтому существующие записи никогда не обновляются. Для одной записи используйте data_create.

Выводит список записей в сущности. Возвращает одну страницу записей (строк), по умолчанию 20. Фильтрует по значениям полей с помощью JSON, например {"status":"draft","price":{"gte":10}}, или пар, например status=draft&price=GTE:10. Использует data_get, когда известен id записи, или search_query, чтобы найти записи по тексту во всех сущностях. Возвращает JSON.

Просматривает или задаёт доступ пользователей к записи по RLS (безопасность на уровне строк). Без идентификатора пользователя возвращает пользователей, у которых есть доступ к записи по RLS (безопасность на уровне строк), их имена и информацию о том, доступ только для чтения или нет. С идентификатором пользователя выдаёт этому пользователю доступ к записи: полный по умолчанию или только для чтения, если запрошено. Не может отзывать доступ и работает только с сущностями, где включён RLS. Изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Обновляет запись. Изменяет только поля, указанные в JSON-объекте, и возвращает обновлённую запись; остальные поля сохраняют свои значения. Объекты или массивы, заданные для полей jsonb, автоматически отправляются как JSON-строки. Рабочие процессы с триггером EntityUpdated на этой сущности запустятся. Чтобы создать запись вместо этого, используйте data_create. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Печатает полную справку по CLI (markdown или --json для использования ИИ/инструментами). Печатает написанную вручную справку по командам CLI, опциям и примерам, не вызывая API и не требуя проекта. Пропускает некоторые группы, например integrations, secrets, API keys и settings, поэтому считайте список инструментов источником истины о том, что есть. Возвращает JSON.

Отрисовывает незакоммиченную тему + содержимое + необязательную обёртку, выводит HTML. Отрисовывает тему и тело черновика с тестовыми данными внутри черновой оболочки, если она задана, иначе внутри текущей оболочки проекта, и возвращает HTML. Ничего не сохраняется, письмо не отправляется. Используйте его, чтобы проверить правки перед email_templates_update или email_shell_update.

Показывает текущий HTML оболочки (пользовательский или платформенный по умолчанию). Возвращает HTML-разметку, которая оборачивает тело каждого письма, отправляемого проектом, и сообщает, задана она вручную или это вариант платформы по умолчанию. Плейсхолдер {{Content}} отмечает место, куда подставляется тело шаблона. Прочитайте её перед email_shell_update.

Сохраняет новую HTML-оболочку или передаёт --reset, чтобы вернуть стандартный вариант платформы. Заменяет HTML-разметку вокруг каждого письма, которое отправляет проект, а с reset возвращает стандартный вариант платформы. Оставляйте плейсхолдер {{Content}} там, где должно быть тело письма; сервер очищает HTML. Сначала проверьте черновик с помощью email_preview. Он изменяет или удаляет существующие данные, поэтому перед запуском согласуйте с пользователем.

Перечисляет все шаблоны писем для этого проекта. Показывает тип каждого шаблона (например, confirmation, invite или recovery), тему и то, заблокирован он или активен. Это письма аккаунта, которые Anythink отправляет для проекта; передайте тип в email_templates_show, чтобы прочитать один, или в email_templates_update, чтобы изменить его.

Показывает тему и содержимое шаблона или отрендеренный HTML с --rendered. По умолчанию возвращает сохранённые тему и содержимое с нетронутыми {{ placeholders }}, именно их и нужно редактировать; с rendered возвращает полный HTML письма внутри оболочки проекта, заполненный тестовыми данными. Прочитайте это перед email_templates_update.

Обновляет тему и/или содержимое шаблона. Сохраняет новую тему и/или тело для одного типа шаблона, а то, что вы пропустили, оставляет без изменений; каждое письмо этого типа, которое проект отправляет с этого момента, использует новые данные. Передавайте тело прямо в content_text. Сначала проверьте черновик с помощью email_preview, так как предыдущее содержимое не сохраняется. Инструмент изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Создаёт новую сущность. Создаёт пустую сущность - новую таблицу базы данных в активном проекте; добавьте её столбцы позже с помощью fields_add. Опции делают её публичной (доступной для запросов без входа в систему), включают безопасность на уровне строк (RLS), блокируют новые записи через API или помечают её как связующую таблицу многие-ко-многим.

Удаляет сущность и все её данные. Удаляет таблицу сущности, безвозвратно стирая все её поля и каждую запись в ней. Чтобы удалить один столбец, используйте fields_delete; чтобы удалить одну запись, используйте data_delete. Инструмент изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Получает сведения о сущности и полях. Принимает имя сущности. Возвращает имя её таблицы, её флаги public, RLS и lock-new-records, а также id, name, тип в базе данных, тип отображения и флаги required, unique и indexed каждого поля. Для полного определения одного поля, включая relationship и select options, используйте fields_get.

Перечисляет все сущности. Возвращает каждую сущность (таблицу) в активном проекте вместе с её именем таблицы в базе данных, количеством полей и информацией о том, публичная она или для неё включена защита на уровне строк (RLS). Системные сущности не выводятся. Чтобы посмотреть настройки и определения полей одной сущности, используйте entities_get.

Обновляет настройки сущности. Изменяет настройки публичного доступа, безопасности на уровне строк (RLS) и блокировки новых записей сущности; все неуказанные настройки сохраняют текущие значения. Не может переименовать сущность или изменить её поля, поэтому для столбцов применяется fields_update. Публичный доступ к сущности позволяет любому запрашивать её записи без входа в систему. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Выполняет аутентифицированный API-запрос к активному проекту. Отправляет запрос на любой эндпоинт проекта, путь указывается относительно /org/{project}, использует учётные данные CLI и выводит тело ответа. Используйте его только там, где нет отдельного инструмента, например, /permissions или параметры поля интеграции; POST, PUT и DELETE меняют данные. all обходит все страницы GET. Он меняет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Добавляет поле в сущность. Добавляет столбец в существующую сущность; тип базы данных нужно указывать всегда. Тип отображения по умолчанию берётся из него (varchar: input, boolean: checkbox, relationships: relationship). Для типов связей требуется имя целевой сущности, а on-delete по умолчанию принимает значение CASCADE; поля user и file автоматически связываются с пользователями и файлами. Возвращает id нового поля.

Удаляет поле из сущности. Принимает имя поля, а не его id, и удаляет этот столбец из сущности, поэтому значение, которое хранил этот столбец, теряется из каждой записи. Чтобы удалить всю сущность и её записи, используйте entities_delete. Изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Получает полное определение одного поля (включая конфигурацию связей). Находит поле по имени в сущности (без учёта регистра) и возвращает его полное определение в виде объекта JSON, включая настройки связей, параметры выбора, значение по умолчанию и флаги поиска. Чтобы увидеть все поля сущности сразу, используйте fields_list.

Перечисляет поля сущности. Принимает имя сущности. Возвращает для каждого поля его id, name, label, тип базы данных, тип отображения и флаги required, unique, indexed и locked. Для полного определения одного поля, включая целевой объект связи и параметры выбора, применяется fields_get; для собственных настроек сущности применяется entities_get.

Обновляет свойства существующего поля. Изменяет метку, описание, тип отображения, значение по умолчанию, варианты выбора поля и его флаги required, searchable, public-search и indexed. Настройки, которые не переданы, сохраняют своё значение, кроме описания: оно очищается, если не передать его снова. Не может переименовать поле или изменить его тип в базе данных, а заблокированные поля отклоняет. Изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Удаляет файл по ID. Удаляет файл из хранилища проекта по его id. Записи, которые ссылаются на него через поле file, подчиняются правилу on-delete этого поля; при значении по умолчанию, CASCADE, они тоже удаляются. Чтобы сначала посмотреть, что хранится, используйте files_get. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Получает метаданные файла по ID. Возвращает исходное и сохранённое названия одного файла, его тип, размер, публичный ли он и когда он был загружен. Даёт только метаданные, а не содержимое файла или ссылку на скачивание. Чтобы просмотреть все файлы, используйте files_list.

Перечисляет загруженные файлы. Возвращает одну страницу загруженных файлов проекта, по умолчанию 25, для каждого файла указывает id, исходное имя, тип, размер, публичный ли он и когда загружен. Используйте files_get для подробностей об одном файле, включая имя, под которым он хранится.

Загружает файл. Загружает файл из пути на машине, где запущен CLI, в файловое хранилище проекта и возвращает его новый id и сохранённое имя. По умолчанию файлы приватные; публичный файл можно получить без входа в систему. Используйте возвращённый id как значение поля файла с помощью data_create или data_update.

Импортирует коллекции, поля, потоки и данные из экземпляра Directus. Записывает в активный проект: сначала необходимо запустить с --dry-run, а --yes добавлять только после того, как пользователь одобрит план. Копирует коллекции и поля экземпляра Directus в активный проект как сущности и поля; потоки, файлы, роли и записи переносятся только с include_flows, include_files, include_roles и include_data. Сначала необходимо вызвать его с dry_run и показать пользователю план, потому что вызов без dry_run сразу применяет импорт. Возвращает JSON. Он изменяет или удаляет существующие данные, поэтому перед запуском необходимо проверить у пользователя.

Подключается к провайдеру с помощью API-ключа (запрашивает ключ, если он не указан). Только для провайдеров, у которых тип аутентификации - api_key (см. integrations_get); провайдеры OAuth здесь не сработают, для них нужен integrations_oauth_configure. Хранит ключ в зашифрованном виде на сервере и создаёт подключение для всего проекта или приватное с user_connection, выводя его id. Ключ передаётся в api_key, затем подключение проверяется с помощью integrations_test.

Перечисляет ваши подключения интеграций. Показывает id каждого подключения, провайдера, имя, область (весь проект или один пользователь) и включено ли оно; сохранённые учётные данные никогда не показываются. Используйте id с integrations_test, integrations_enable, integrations_disable и integrations_disconnect.

Отключает соединение. Не позволяет integrations_execute и шагам рабочего процесса использовать соединение, но сохраняет его учётные данные, поэтому integrations_enable может снова его включить. Предпочитайте это вместо integrations_disconnect, если пауза может быть временной.

Удаляет подключение. Удаляет подключение и его сохранённые учётные данные из проекта; шаги workflow, которые от него зависят, будут падать, пока провайдер не будет подключён снова с помощью integrations_connect или OAuth-потока. Чтобы приостановить его, можно использовать integrations_disable. Он изменяет или удаляет существующие данные, поэтому перед запуском нужно уточнить у пользователя.

Включает соединение. Снова включает отключённое соединение, чтобы integrations_execute и шаги workflow могли снова его использовать; сохранённые учётные данные не меняются. Возвращает имя соединения и новое состояние. Обратное действие выполняет integrations_disable.

Выполняет операцию у подключённого провайдера. Обращается к провайдеру напрямую через первое включённое подключение проекта к нему, передавая входные данные в виде пар key=value или объекта JSON, и может повлечь расходы у провайдера. API сейчас запускает только провайдера claude (входные параметры prompt, system_prompt, model, max_tokens); остальные провайдеры возвращают ошибку, поэтому используйте их в шагах workflow через workflows_integration_add. Возвращает JSON.

Показывает сведения и операции для одного провайдера. Показывает описание провайдера, тип авторизации, а также ключ, имя и описание каждой операции. Ключи операций передают в integrations_execute и в шаги интеграции workflow (workflows_integration_add). Про подключён ли проект, он не сообщает; это делает integrations_connections_list.

Выводит список доступных провайдеров интеграций. Начните отсюда, когда подключаете сторонний сервис. Показывает ключ, категорию, тип аутентификации (api_key или oauth2) и количество операций для каждого провайдера; провайдеры, отключённые для этого проекта, в список не попадают. Дальше получите провайдера через integrations_get, затем подключите его с помощью integrations_connect (API key) или integrations_oauth_configure (OAuth).

Печатает URL перенаправления для добавления в конфигурации OAuth-приложения (одинаков для каждого провайдера). Печатает только URL перенаправления дашборда для этого проекта, вычисленный локально из адреса API и идентификатора проекта без вызова API. Передаёт его пользователю, чтобы тот добавил его в своё OAuth-приложение у провайдера перед integrations_oauth_configure; integrations_oauth_status показывает его вместе с состоянием настройки провайдера.

Устанавливает OAuth client ID и секрет для провайдера. Сохраняет client ID и секрет OAuth-приложения, которое пользователь создал у провайдера, и включает его для проекта (disable сохраняет его выключенным). Каждый запуск заменяет предыдущие настройки, поэтому вход через соцсети отключается, если снова не передать use_social_sign_in. После этого пользователи подключаются из панели управления или с помощью integrations_oauth_connect. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Подключается через браузерный OAuth-поток (запускает локальный слушатель). Открывает страницу входа провайдера в браузере на этой машине и ждёт колбэк на localhost до пяти минут (порт 8745 по умолчанию), затем создаёт подключение. Завершить вход должен человек, а провайдера сначала нужно настроить через integrations_oauth_configure; для провайдеров с API-ключом используйте integrations_connect.

Показывает статус настройки OAuth-клиента для провайдера. Показывает, сохранён ли client ID для провайдера, включён ли он и используется ли также для социального входа конечных пользователей, и redirect URL, который должно разрешать его OAuth-приложение. Проверяет его перед integrations_oauth_configure или после, чтобы убедиться, что учётные данные сохранены.

Проверяет подключение. Вызывается после подключения, с id из integrations_connections_list. API сейчас только подтверждает, что подключение существует в этом проекте, и не обращается к провайдеру, поэтому успешная проверка не доказывает, что сохранённые учётные данные работают.

Входит в платформу Anythink с помощью email и пароля. Возвращает токен сессии для управления аккаунтом и проектами. Для входа через Google используйте инструмент 'login_google'.

Сохраняет учётные данные напрямую для проекта (в обход входа в биллинг). Используйте этот инструмент, когда у вас уже есть ID организации и API-ключ или JWT-токен.

Выполняет вход на платформу Anythink через Google. Открывает браузер пользователя на экране согласия Google и ждёт, пока пользователь подтвердит, затем сохраняет токен сессии. Шаг с браузером должен выполнить пользователь; всё до и после делает инструмент. Это НЕ выбирает платёжный аккаунт или проект. После возврата вызовите 'accounts_list', затем 'accounts_use', и 'projects_list', затем 'projects_use'. Требует локальный браузер, поэтому работает только через stdio (а не через HTTP-сервер на хостинге).

Удаляет сохранённые учётные данные профиля проекта из локальной конфигурации CLI. Используется, чтобы отключиться от проекта или очистить устаревший токен; удаляет только сохранённый профиль локально и не отзывает токен на стороне сервера и не затрагивает проект. Если не указать профиль, удаляется текущий активный. Имена профилей показывает 'config_show'.

Добавляет пункт меню для сущности. Пункт ссылается на страницу данных сущности в дашборде, получает имя по названию сущности в стиле Title Case, если не указано name, использует иконку Lucide (по умолчанию Database) и идёт последним на верхнем уровне или под parent. Сущность должна существовать; чтобы сослаться на другой путь, добавьте пункт и затем задайте href с помощью menus_update_item.

Создаёт меню для роли. Новое меню пустое; добавляет элементы с помощью menus_add_item. Для роли отображается только её первое меню, поэтому второе меню для той же роли может не появиться; использует menus_reorder, чтобы выбрать, какое идёт первым.

Удаляет меню и все его пункты. Удаляет меню и каждый пункт в нём, включая заблокированные встроенные пункты, и отменить это нельзя. Если это было единственное меню роли, роль останется без меню дашборда; чтобы удалить отдельные пункты, используйте menus_remove_item. Инструмент изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Показывает одно меню с его пунктами и их дочерними пунктами. Даёт role id меню и его полное дерево пунктов, с id, name, icon, href, parent каждого пункта и информацией, заблокирован ли он как встроенный пункт. Помогает найти item ids для menus_update_item, menus_remove_item и menus_reorder_items. Возвращает JSON.

Перечисляет все меню и их элементы. Показывает каждое меню с его id, названием и id роли, которой оно показывается, а также id, названия, иконки и ссылки его элементов. Перечисляются только элементы верхнего уровня и их прямые дочерние элементы; чтобы получить полное дерево элементов одного меню, включая сведения о том, какие элементы заблокированы, используйте menus_get.

Удаляет пункт меню вместе с его дочерними пунктами. Удаляет элемент и его непосредственные дочерние элементы из меню. Отказывается от заблокированных встроенных пунктов и пунктов, дочерние пункты которых заблокированы или имеют собственные дочерние пункты; сначала переместите их с помощью menus_update_item. Изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Задаёт порядок меню. Меню, которые вы назовёте, идут первыми в указанном порядке, остальные следуют в текущем порядке. Порядок важен, когда у роли больше одного меню, потому что роли показывают только первое; чтобы изменить роль меню, используйте menus_update. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Задаёт порядок пунктов меню, у которых общий родитель. Пункты должны иметь одного родителя: те, которые вы назовёте, занимают первые места в этой группе в указанном порядке, остальные пункты того же уровня идут в текущем порядке, а заблокированные пункты остаются на своих местах. Чтобы переместить пункт к другому родителю, используйте menus_update_item. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Переименовывает меню или меняет роль, которой оно показывается. Меняет название меню, роль, которой оно показывается, или и то и другое; пункты остаются как есть. У роли отображается только её первое меню, поэтому перенос меню на роль, у которой уже есть меню, может его скрыть; используйте menus_reorder, чтобы выбрать, какое будет первым. Меняет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Меняет название пункта меню, иконку, ссылку или родителя. Меняет только те поля, которые вы передаёте: name, иконку Lucide, entity (ссылается на страницу этой сущности) или href (любой путь), и parent (0 для верхнего уровня). Перемещённый пункт встаёт последним у нового родителя, а заблокированные встроенные пункты изменить нельзя. Чтобы изменить порядок пунктов, не перемещая их, используйте menus_reorder_items. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Задаёт client ID и секрет Google OAuth. Сохраняет client ID и секрет клиента Google Cloud OAuth, которые дают конечным пользователям проекта входить через Google, и включает или выключает этот вход. Работает только в интерактивном режиме: запрашивает каждое значение (пустое оставляет текущее), затем выводит callback URL, который нужно добавить в клиент Google OAuth. Меняет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Показывает статус конфигурации Google OAuth. Сообщает, включён ли вход через Google для конечных пользователей проекта и сохранены ли client ID и secret, не показывая их. Это касается только входа пользователей; Google как интеграция обрабатывается через integrations_oauth_status и integrations_oauth_configure.

Настраивает аккаунт Stripe Connect и запускает онбординг. Создаёт аккаунт Stripe Connect для проекта и открывает страницу онбординга, размещённую Stripe, в браузере, которую нужно завершить, прежде чем тарифы смогут принимать оплату картой. Запрашивает тип бизнеса, страну и email, поэтому нужен интерактивный терминал. Сначала проверьте pay_status.

Показывает текущий доступ пользователя / право на пробный период. Сообщает, есть ли у вошедшего пользователя (от имени которого запускается этот инструмент) платный или пробный доступ в приложении проекта: статус, окончание пробного периода и оставшиеся дни, идентификатор подписки, провайдер, продукт и срок действия. Только для чтения. Чтобы найти другого пользователя, используйте pay_subscriptions_by_user.

Выводит сохранённые способы оплаты. Показывает карты и другие способы оплаты, сохранённые авторизованным пользователем как клиентом этого проекта: тип, бренд, последние четыре цифры и срок действия. Не показывает карты ваших конечных пользователей или карту в вашем биллинговом аккаунте Anythink. Только для чтения.

Активирует приостановленное предложение. Переводит предложение в статус active, чтобы его коды снова можно было погасить, при этом продолжают действовать сроки действия и лимиты. Используйте его, чтобы отменить pay_offers_pause или снова открыть истёкшее предложение.

Добавляет промокод/реферальный код к офферу. Создаёт код, который пользователи вводят, чтобы активировать оффер: общий промокод или, если указан owner user id, персональный реферальный код, привязанный к этому пользователю. Возвращает новый код. Отдельного инструмента для удаления одного кода нет; коды исчезают только вместе с оффером при удалении через pay_offers_delete.

Выводит промокоды/реферальные коды, привязанные к предложению. Перечисляет каждый код в одном предложении, как общие промокоды, так и персональные реферальные коды, со slug, владельцем (или общим), количеством погашений и датой создания. Только для чтения. Чтобы найти персональный реферальный код конкретного пользователя, используйте pay_offers_user_code.

Создаёт оффер (награды через удобные флаги или raw JSON). Создаёт оффер типа discount, trial_extension или referral. Награда получателя обязательна, в виде raw JSON или сокращения, например, trial days или discount percent; награда реферера, условия участия, лимиты и даты необязательны. Офферы со скидкой также создают купон Stripe. Добавляет код, который пользователи могут ввести с помощью pay_offers_add_code.

Безвозвратно удаляет оффер и все его коды + погашения (история теряется; уже начисленные бонусы за пробный период сохраняются). Возвращает, сколько кодов и погашений удалено и сколько бонусов за пробный период сохранено. Купон Stripe у оффера не удаляется. Чтобы остановить погашения и сохранить историю, вместо этого используйте pay_offers_pause. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Показывает одно предложение по id (guid). Показывает одно предложение полностью: вид, описание, статус, основной код, вознаграждения получателя и реферера, правила допуска, лимиты на пользователя и общий лимит, даты действия и id связанного купона Stripe. Только для чтения; его коды и погашения берутся из pay_offers_codes и pay_offers_redemptions.

List offers. Перечисляет предложения проекта (скидки, продления пробного периода и реферальные схемы, которые пользователи активируют по коду): id, name, kind, primary code, redeemer and referrer rewards и status. Только для чтения. Предложения идут отдельно от планов подписки (pay_plans_list).

Приостанавливает оффер. Устанавливает статус оффера в paused, так что ни один из его кодов нельзя погасить; прошлые погашения и уже выданные награды остаются. Обратимо с помощью pay_offers_activate. Лучше использовать этот инструмент вместо pay_offers_delete, чтобы остановить оффер, не теряя его историю. Изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Выводит список погашений для оффера. Показывает, кто погасил один оффер, с постраничной разбивкой: погасивший, статус его награды, реферер, если он есть, и статус награды реферера, а также когда это было погашено. Только для чтения; служит для проверки, были ли начислены реферальные награды.

Обновляет предложение (patch: изменяются только переданные поля; kind неизменяем). Изменяет название, описание, вознаграждения, условия соответствия, ограничения, даты или статус предложения; пропущенные поля сохраняются. Установка статуса paused или expired останавливает погашение его кодов. Изменение вознаграждения в виде скидки не обновляет купон Stripe, созданный при создании. Если нужно изменить только статус, pay_offers_pause и pay_offers_activate проще. Изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Ищет персональный реферальный код пользователя. Возвращает персональный реферальный код одного пользователя (по числовому id пользователя) вместе с его slug, названием оффера и количеством погашений. Если у пользователя ещё нет кода, сервер создаёт его, поэтому этот вызов может создать код. Чтобы вывести список всех кодов для одного оффера, используйте pay_offers_codes.

Показывает доступные платёжные провайдеры для платформы/витрины. Показывает, какие платёжные провайдеры (например, Stripe или Apple in-app purchase) проект предлагает приложению на платформе (ios, android или web), опционально для кода страны витрины App Store. Только для чтения; с его помощью можно увидеть, что будет предложено клиентскому приложению.

Перечисляет последние платежи. Перечисляет карточные платежи, которые проект принял от своих конечных пользователей через AnythinkPay (Stripe), с id, суммой, валютой, статусом, описанием и датой, с пагинацией по page и limit. Только чтение; инструмента возврата нет. Для записей о регулярных списаниях используйте pay_subscriptions_list.

Создаёт план подписки (запрашивает недостающие поля). Создаёт план подписки (повторяющуюся цену, которую могут купить конечные пользователи), по умолчанию gbp, monthly, type web и active, а после подключения Stripe Connect синхронизирует соответствующий продукт и цену Stripe. Ни с кого не списывают деньги, пока пользователь не оформит подписку. Задаёт Apple product id, чтобы сопоставить с ним покупку в приложении.

Удаляет план подписки. Удаляет план подписки, чтобы его больше нельзя было выбрать. Существующие подписки на нём, а также его продукт и цена в Stripe, остаются на месте, и биллинг по ним продолжается. Чтобы обратимо скрыть план, используйте pay_plans_update с inactive. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Показывает один план по id. Показывает один из планов подписки проекта полностью, включая тип, цену и интервал, пробный период, название и описание продукта Stripe, reference, идентификаторы продукта Apple и группы подписок, а также активен ли он. Только для чтения; для просмотра планов используйте pay_plans_list.

List subscription plans. Перечисляет собственные планы подписки проекта, регулярные цены, на которые могут подписаться его конечные пользователи: id, внутреннее название плана, отображаемое название, цена за интервал, дни пробного периода, Apple product id и активен ли план. Только для чтения. Не то же самое, что plans, который перечисляет хостинговые планы Anythink для проектов.

Обновляет план подписки (любой --flag переопределяет; unset = keep). Изменяет план подписки; пропущенные поля сохраняют текущие значения, а active или inactive показывает или скрывает его в списке выбора плана. Изменение суммы, валюты или интервала переводит план на новую цену Stripe для новых регистраций; существующие подписки сохраняют старую цену. Лучше inactive, чем pay_plans_delete. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Показывает статус аккаунта Stripe Connect. Считывает аккаунт Stripe Connect проекта, аккаунт, на который поступают карточные платежи ваших конечных пользователей: id аккаунта, завершён ли онбординг, включены ли списания и выплаты. Только для чтения. Если аккаунта нет или онбординг не завершён, используйте pay_connect.

Перечисляет подписки, доступные пользователю. Выводит список подписок, к которым привязан один пользователь проекта (по числовому id пользователя), с id, именем, статусом, ценой и датой создания. Только для чтения. Используйте его для поиска подписок клиента; pay_entitlement и pay_subscriptions_check_access сообщают только о вошедшем в систему пользователе.

Отменяет подписку. Планирует отмену подписки Stripe в конце текущего расчётного периода: до этого момента клиент сохраняет доступ, и с него больше не списывают деньги. Отмена обратима до конца периода с помощью pay_subscriptions_resume. Подписки Apple отменяет клиент в App Store. Чтобы прекратить доступ сейчас, см. pay_subscriptions_force_expire. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Проверяет, есть ли у текущего пользователя доступ к подписке по имени. Проверяет, есть ли у вошедшего пользователя (того, от чьего имени работает этот инструмент) подписка с заданным именем, может дополнительно требовать конкретный статус и возвращает, есть ли у него доступ, а также id, имя и статус этой подписки. Работает только на чтение. Для другого пользователя используйте pay_subscriptions_by_user.

Жёстко удаляет подписку (администратор проекта). Инструмент восстановления для администратора проекта, который безвозвратно удаляет зависшую или дублирующую запись подписки и её связи с пользователями из Anythink. Он не отменяет подписку в Stripe или Apple, поэтому клиенту всё ещё могут выставить счёт; сначала используйте pay_subscriptions_cancel, если списания нужно остановить. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Показывает историю жизненного цикла подписки. Возвращает историю жизненного цикла подписки, по одной строке на событие со временем, типом события, источником, изменением статуса и сводкой. Только для чтения; проверяйте её, чтобы объяснить состояние подписки перед использованием pay_subscriptions_cancel, pay_subscriptions_resync или pay_subscriptions_relink.

Принудительно помечает подписку как expired немедленно (администратор проекта). Инструмент восстановления для администратора проекта, который устанавливает статус подписки в expired и очищает текущий период, так что пользователь сразу теряет доступ, а запись сохраняется. Меняет только запись в Anythink, но не в Stripe или Apple, поэтому не останавливает будущие списания; для этого используйте pay_subscriptions_cancel. Меняет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Показывает одну подписку по id (guid). Показывает одну подписку полностью: статус, цену, email и имя клиента, текущий расчётный период, окончание пробного периода, даты отмены и запланированной автоотмены, референс и любой URL оформления заказа. Только для чтения; чтобы узнать, как она попала в это состояние, используйте pay_subscriptions_events.

Выводит список подписок (с постраничной разбивкой, с необязательной фильтрацией по --status). Выводит подписки проекта (регулярные покупки плана конечными пользователями через Stripe или Apple) с id, name, status, price, customer email и created date, с постраничной разбивкой, с необязательной фильтрацией по статусу, например active, trialing или cancelled. Только для чтения. Неадминистраторы видят только подписки, с которыми связаны.

Перемещает подписку другому пользователю (администратор проекта). Инструмент администратора проекта, который перемещает подписку другому пользователю проекта (числовой id пользователя), заменяя все существующие привязки пользователей к ней, чтобы исправить покупку, привязанную к неверному аккаунту. Предыдущий пользователь теряет доступ; биллинг в Stripe или Apple не меняется. Отменить можно, привязав её обратно. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Возобновляет отменённую подписку. Удаляет запланированную отмену из подписки Stripe, чтобы она продлилась и снова списала средства с клиента в конце текущего периода. Используйте его, чтобы отменить pay_subscriptions_cancel до окончания периода.

Повторно синхронизирует подписку от провайдера (администратор проекта). Инструмент администратора проекта, который получает текущее состояние подписки Stripe из Stripe и перезаписывает сохранённую запись, возвращая результат. Используйте его, когда отображаемый статус не совпадает с Stripe. Подписки Apple пока не поддерживаются и возвращают ошибку. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Отключает пробный период вовлечения в приложение. Выключает пробный период вовлечения в приложение на уровне проекта, поэтому пользователи без подписки больше не получают бесплатный доступ к приложению. Меняет только эту настройку проекта, остальные оставляет как были; отменить можно с помощью pay_trial_enable. Пробные дни, выданные по офферам, идут отдельно, и это их не затрагивает.

Включает пробный период вовлечённости в приложение. Запускает пробный период вовлечённости в приложение для всего проекта, чтобы пользователи без подписки получали бесплатный доступ к приложению на срок самого длинного пробного периода среди активных планов. Меняет только эту настройку проекта, а остальные оставляет как были; отменить с помощью pay_trial_disable. Не связано с наградами за пробный период оффера (pay_offers_create).

Показывает, включён ли триал, и его вычисленную длительность. Сообщает, включён ли триал app engagement для всего проекта и сколько он длится. Длительность не задаётся напрямую: это самый длинный триал среди активных планов подписки, и этот план указывается. Только для чтения; изменить можно с помощью pay_trial_enable, pay_trial_disable или дней триала плана в pay_plans_update.

Создаёт новый проект: выделенный изолированный экземпляр бэкенда Anythink с собственной базой данных, API, аутентификацией и хранилищем. Требует входа на платформу и активного платёжного аккаунта (задать его можно с помощью 'accounts_use'). Подготовка идёт асинхронно: проект стартует в состоянии Provisioning, поэтому нужно опрашивать 'projects_list', пока он не станет Active. Возвращает id, имя, org id и API URL нового проекта. Подключается к нему с помощью 'projects_use'.

Безвозвратно удаляет проект и сносит его backend-инстанс вместе с базой данных и хранимыми данными. Операция разрушительная и необратимая: всегда сначала подтверждайте её у пользователя и предпочитайте сопоставление по конкретному id, а не по короткому префиксу, чтобы не удалить не тот проект. Требует активного платёжного аккаунта (задайте его с помощью 'accounts_use'). При успехе возвращает имя и id удалённого проекта.

Перечисляет проекты (подготовленные экземпляры бэкенда) в платёжном аккаунте. Требует входа в платформу и активного платёжного аккаунта (задайте его с помощью 'accounts_use'). Возвращает для каждого проекта id, имя, описание, регион, id организации, статус (Initializing/Provisioning/Active/Suspended/Terminated/Error), URL API и дату создания. Используйте это, чтобы найти id проекта перед подключением через 'projects_use' или удалением с помощью 'projects_delete'.

Подключается к проекту и сохраняет его как активный профиль, чтобы команды data, entities, users и другие команды инструмента 'cli' работали с ним. Определяет проект, затем либо сохраняет переданный вами API-ключ, либо автоматически обменивает transfer token на учётные данные, привязанные к проекту. Требуется активный платёжный аккаунт (задайте его с помощью 'accounts_use'); проект должен находиться в состоянии Active (см. 'projects_list'). Возвращает имя сохранённого профиля, идентификатор организации, URL API и метод аутентификации.

Создаёт новую роль. Добавляет роль, у которой пока нет разрешений на сущности, поэтому её пользователи не смогут получить доступ ни к каким данным, пока вы не выдадите права на действия через roles_permissions_add. Затем выдаёт её пользователям, передавая её id как role_id в users_invite. Имена ролей должны быть уникальными в проекте.

Удаляет роль по ID. Удаляет роль и права, которые она выдаёт. API отклоняет запрос, пока роль назначена хотя бы одному пользователю, а встроенную роль admin удалить нельзя, поэтому сначала проверьте users_list, чтобы найти пользователей с этой ролью. Чтобы забрать только часть доступа, используйте вместо этого roles_permissions_remove. Инструмент меняет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Перечисляет все роли. Перечисляет роли проекта с id, name, description и информацией, активна ли каждая. Доступ работает через роли: у каждого пользователя одна роль, а роль даёт права на действия (read, create, update, delete) для каждой сущности. Используйте roles_permissions_list, чтобы посмотреть, какие права даёт одна роль.

Добавляет роли разрешения на сущность. Предоставляет роли одно или несколько действий (read, create, update, delete; по умолчанию read) над одной сущностью, и каждый пользователь, имеющий эту роль, получает их сразу. Остальные её разрешения сохраняет, а действия, которые у неё уже есть, пропускает. О действии, для которого нет подходящего разрешения для этой сущности, сообщает и пропускает его.

Выводит список разрешений на сущности для роли. Показывает по каждой сущности, какие действия (read, create, update, delete) предоставляет роль. Используйте его перед roles_permissions_add или roles_permissions_remove либо чтобы объяснить, почему пользователи с этой ролью могут или не могут получить доступ к каким-то данным.

Удаляет у роли разрешения на сущность. Забирает у роли одно или несколько действий (по умолчанию read) над одной сущностью; все пользователи с этой ролью теряют их сразу, а остальные разрешения роли сохраняются. Действия, которых у роли нет, игнорируются. Сначала вызовите roles_permissions_list, чтобы посмотреть, что она выдаёт. Инструмент изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Сравнивает настроенные поля, доступные для публичного поиска, с тем, что публичный поиск реально возвращает. Отмечает любые утечки данных. Запускает один и тот же запрос (по умолчанию *) через публичный поиск и поиск с авторизацией для одной сущности, по умолчанию делает выборку из 5 записей и сообщает о любом поле, которое вернул публичный поиск и которое не помечено как доступное для публичного поиска, а также о помеченных полях, которые не появились. Завершается ошибкой, когда находит утечку. Исправляйте утечки с помощью fields_update. Возвращает JSON.

Очищает поисковый индекс. Если ENTITY не указан, очищает всё (только для администратора). Удаляет записи поискового индекса для сущности или для всех сущностей, поэтому search_query и search_similar ничего для них не возвращают, пока не выполнится search_rehydrate. Записи в базе данных не трогаются. Изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Запускает поисковый запрос. Ищет в поисковом индексе по всем проиндексированным сущностям или по перечисленным, с необязательным фильтром (status=published AND category=news), сортировкой, фасетами и подсветкой; используйте * для просмотра. Опция public выполняет поиск от имени анонимного посетителя. Чтобы вывести записи одной сущности по точным значениям полей, используйте data_list; если проиндексированные записи отсутствуют, используйте search_rehydrate. Возвращает JSON.

Перезаполняет поисковый индекс. Пропустите ENTITY, чтобы перезаполнить всё (только для администраторов). Повторно отправляет записи сущности или всех сущностей из базы данных в поисковый индекс, заменяя существующие записи; работает в фоне и может занять время на больших сущностях. Используйте его, когда search_query не находит записи, или после изменения того, какие поля доступны для поиска. Данные не меняет; чтобы вместо этого очистить индекс, используйте search_purge.

Находит документы, похожие на заданную запись (векторный поиск). Принимает сущность и идентификатор записи и возвращает записи, ближайшие по смыслу к ней, по умолчанию 10, с помощью векторных эмбеддингов в поисковом индексе. Опция public выполняет поиск как анонимный посетитель и возвращает только поля, доступные для публичного поиска. Чтобы найти записи, совпадающие со словами, которые вы указали, используйте search_query. Возвращает JSON.

Сохраняет новое значение секрета. Сохраняет значение в зашифрованном виде в проекте под ключом, чтобы рабочие процессы могли ссылаться на него как на {{ $anythink.secrets.KEY }}; его никогда нельзя прочитать обратно. Передавайте его в value, так как инструмент не может ответить на скрытый запрос. Чтобы изменить существующий секрет, используйте secrets_update.

Удаляет секрет. Безвозвратно удаляет ключ и его зашифрованное значение; рабочие процессы, которые ссылаются на него как {{ $anythink.secrets.KEY }}, дают сбой, пока его не создадут заново. Чтобы изменить значение, используйте secrets_update. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Перечисляет все секретные ключи (только метаданные, значения никогда не показываются). Показывает ключ каждого секрета, пользователей, которым он назначен, а также когда его создали и обновили; значения никогда не возвращаются. Используйте его, чтобы проверить, существует ли ключ, прежде чем ссылаться на него в рабочем процессе как {{ $anythink.secrets.KEY }}, или перед secrets_update или secrets_delete.

Ротирует (перезаписывает) существующее значение секрета. Перезаписывает сохранённое значение существующего ключа, например, чтобы ротировать учётные данные; старое значение теряется, а рабочие процессы, ссылающиеся на ключ, используют новое начиная со следующего запуска. Передайте новое значение в value. Используйте secrets_create для ключа, которого ещё нет. Инструмент изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Добавляет разрешённый источник (очищает кеш CORS). Добавляет источник веб-приложения (схема, хост и необязательный порт, без пути) или wildcard вроде https://*.example.com, чтобы браузерные приложения оттуда могли сразу обращаться к API проекта. Wildcard на общем хостинге вроде vercel.app доверяет чужим сайтам, поэтому сначала уточните у пользователя. Источник, который уже в списке, остаётся как есть.

Перечисляет разрешённые URL приложений. Показывает origin веб-приложений, которым разрешено вызывать API этого проекта из браузера. Собственные домены Anythink и localhost разрешены всегда и в списке не отображаются. Изменяет список с помощью settings_cors_add и settings_cors_remove.

Удаляет разрешённый origin (очищает кэш CORS). Удаляет origin из списка разрешённых и очищает кэш CORS, поэтому браузерные приложения на этом origin сразу блокируются. Передавайте origin в том виде, в каком его показывает settings_cors_list; значение, которого нет в списке, будет указано в отчёте, и ничего не изменится. Инструмент изменяет или удаляет существующие данные, поэтому перед его запуском уточните у пользователя.

Показывает все настройки проекта. Показывает название проекта, описание, правила подтверждения email и регистрации, роль по умолчанию для новых пользователей, групповой RLS, режим и модель AI, URL-адреса перенаправления платежей, настройки пробного периода и разрешённые источники CORS. Значения вроде секретов, например google_maps_key, отображаются только как заданные. Имена его полей - это ключи, которые принимает settings_set. Возвращает JSON.

Устанавливает одну настройку проекта. Меняет одну настройку с именем, как в settings_get (например, allow_registrations, default_role_id, ai_mode или payment_success_url), а остальные оставляет как есть; булевы значения принимают true или false. Открытие регистрации, отключение подтверждения email или выдача новым пользователям роли администратора проходят без дополнительного запроса. Для CORS origins используйте settings_cors_add. Он меняет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Регистрирует новый аккаунт на платформе Anythink с email и паролем. Используйте этот инструмент только когда у пользователя ещё нет аккаунта; если аккаунт уже есть, используйте 'login'. Создаёт идентификацию пользователя верхнего уровня, но не создаёт биллинговый аккаунт или проект (для этого используйте 'accounts_create' и 'projects_create' после входа). В случае успеха пользователю может понадобиться нажать ссылку подтверждения в письме, прежде чем 'login' сработает; попросите его подтвердить, затем вызовите 'login'.

Удаляет пользователя по ID. Удаляет пользователя из этого проекта, поэтому он больше не сможет войти в него или использовать доступ своей роли. Роль и её разрешения остаются на месте для всех остальных. Сначала с помощью users_get убедитесь, что это нужный человек. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Получает пользователя по ID. Показывает имя пользователя, email, роль, подтвердил ли он своё приглашение и когда его создали. Используйте его, чтобы проверить роль одного человека; используйте users_list, чтобы просмотреть всех, и roles_permissions_list, чтобы увидеть, что разрешает его роль.

Создаёт пользователя и отправляет письмо с приглашением. Добавляет человека в этот проект с ролью, заданной role_id, затем отправляет ему приглашение подтвердить аккаунт. Всегда передавайте role_id из roles_list: API отклоняет приглашение без существующей роли, а роли администратора так выдать нельзя. Сначала проверьте users_list, чтобы никого не пригласить дважды.

Перечисляет всех пользователей. Показывает каждого, кто может войти в этот проект, с его id, именем, email, ролью и информацией о том, подтвердил ли он приглашение. Используйте его, чтобы найти id пользователя или посмотреть, у кого есть роль, прежде чем менять её с помощью roles_permissions_add или удалять с помощью roles_delete.

Показывает текущего аутентифицированного пользователя. Показывает пользователя, под которым вы вошли в этот проект: id, имя, email, роль, подтверждён ли он и когда создан. Ваша роль определяет, что может делать каждый другой инструмент, поэтому проверяйте её, когда вызов отклонён; используйте users_get, чтобы посмотреть другого пользователя.

Создаёт новый workflow. Создаёт workflow с одним триггером и без шагов: Manual требует entity, Timed требует cron, Event требует entity и событие (по умолчанию EntityCreated) и необязательный фильтр, а Api требует api_route. Он остаётся отключённым, пока не задан enabled; добавляйте шаги через workflows_step_add, а затем включайте его через workflows_enable.

Удаляет рабочий процесс. Удаляет рабочий процесс вместе с его триггерами и шагами, поэтому он перестаёт выполняться, и восстановить его нельзя. Для временной остановки служит workflows_disable; для сохранения копии перед удалением служит workflows_export. Он изменяет или удаляет существующие данные, поэтому перед запуском требует уточнения у пользователя.

Отключает рабочий процесс. Останавливает запуск рабочего процесса по его триггерам, но сохраняет его триггеры, шаги и историю заданий, поэтому workflows_enable снова его включает. Предпочитайте это workflows_delete, когда рабочий процесс должен остановиться только на время.

Включает рабочий процесс. Включённый рабочий процесс запускается сам по своим триггерам: Timed: по своему расписанию cron, Event: когда происходит соответствующее событие, Api: когда вызывается его маршрут. Используйте workflows_disable, чтобы приостановить его, не теряя его шагов.

Экспортирует существующий рабочий процесс в JSON (с возможностью обратного импорта с seed). Возвращает определение рабочего процесса в виде JSON без id: его триггеры и его шаги с их параметрами, связанные по ключу шага через on_success/on_failure. Используйте его для резервного копирования или копирования рабочего процесса; для id, которые нужны инструментам шагов, используйте workflows_get. Он изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Добавляет шаг FileHandler с именованными флагами (без написанного вручную JSON params). Шаг прикрепляет файл к полю file записи: fetch_and_link скачивает source_url, link_existing прикрепляет existing_file_id, а detach отвязывает его; entity, record_id (обычно {{ $anythink.trigger.id }}) и field нужны всегда. В отличие от workflows_step_add, он может задавать on_success/on_failure в том же вызове, а шаг создаётся отключённым, если не задан enabled.

Печатает готовый к вставке JSON параметров FileHandler. Пример использует шаблоны {{ $anythink... }} для исходного URL, идентификатора записи и папки и ничего не меняет в проекте. Его можно адаптировать как params для workflows_step_add или workflows_step_update; чтобы добавить шаг FileHandler напрямую, workflows_file_handler_add проще.

Получает сведения о workflow и его шагах. Включает каждый триггер с его последним и следующим запуском, а также каждый шаг с его id, key, action, parameters, флагом start-step и id шагов on_success/on_failure. Использует эти id шагов с workflows_step_update, workflows_step_link и workflows_step_delete; для копии без id использует workflows_export. Возвращает JSON.

Добавляет шаг Integration (Claude, OpenAI, Slack…) с именованными флагами (без JSON параметров, написанного вручную). Шаг выполняет одну операцию провайдера, например claude generate-text, где входные данные задаются парами key=value, которые принимают шаблоны {{ $anythink... }}; ключи провайдера и операции находит через integrations_get. credential_source выбирает учётные данные (system, current_user, connection с connection_id или entity_field), а шаг создаётся отключённым, если не задан enabled.

Просматривает историю заданий рабочего процесса. Показывает 10 последних запусков, у каждого - статус (Completed, Failed или Running), время начала и ошибка, а также статус, ошибка и лог каждого шага. Вызывают его после workflows_trigger или когда событие или расписание должны были сработать, чтобы увидеть, прошёл ли запуск и на каком шаге произошла ошибка.

Перечисляет все рабочие процессы. Каждая запись содержит id, имя, описание, флаг включения, количество шагов и триггеры (Manual, Timed, Event или Api) с их конфигурацией, но не сами шаги. Шаги рабочего процесса и их связи показывает workflows_get. Возвращает JSON.

Создаёт рабочий процесс и его шаги из JSON-файла. Читает JSON-файл на этой машине в формате workflows_export (name, trigger или triggers, а также steps с key, action, parameters и on_success/on_failure по ключу шага), заполняет плейсхолдеры {{KEY}} значениями из var, затем создаёт рабочий процесс, добавляет его шаги и связывает их. Всегда создаёт новый рабочий процесс, поэтому два запуска дадут две копии.

Добавляет шаг в workflow. Параметры - это настройки действия в формате JSON, например {"script":"return {}"} для RunScript или {"entity":"orders","data":{...}} для CreateData. Новый шаг не связан: start устанавливается на первом шаге workflow, а остальные связываются с помощью workflows_step_link. Для шагов FileHandler или Integration workflows_file_handler_add и workflows_integration_add сами собирают параметры за вас.

Удаляет шаг из рабочего процесса (предупреждает, если на него ссылаются другие шаги). API отказывается удалять шаг, на который другие шаги всё ещё ссылаются через on_success или on_failure, поэтому сначала перенаправьте их с помощью workflows_step_link. Удаление начального шага оставляет рабочий процесс без точки входа, пока не добавят новый шаг с start. Изменяет или удаляет существующие данные, поэтому перед запуском согласуйте с пользователем.

Просматривает детали шага, включая параметры. Показывает ключ шага, действие, флаги enabled и start-step, идентификаторы шагов on_success/on_failure и все его параметры. Прочитайте это перед workflows_step_update, потому что параметры, переданные туда, полностью заменяют параметры шага.

Связывает шаги workflow между собой (задаёт on-success/on-failure). Задаёт, какой шаг запускается следующим, когда этот завершается успешно (on_success) или с ошибкой (on_failure), по id шага из workflows_get; пропущенная ссылка сохраняет текущее значение. Ссылки можно изменить, но очистить их здесь нельзя, а поля name, action и params шага остаются как есть. Изменяет или удаляет существующие данные, поэтому перед запуском уточните у пользователя.

Обновляет параметры и свойства шага. Меняет имя шага, params или флаг enabled и сохраняет его action, флаг start и links; может включить шаг, но не отключить. Params заменяют параметры шага целиком, поэтому сначала их читает workflows_step_get; чтобы изменить, какой шаг выполняется следующим, применяется workflows_step_link. Меняет или удаляет существующие данные, поэтому перед запуском его проверяют у пользователя.

Запускает workflow вручную. Сразу запускает выполнение и возвращает управление, не дожидаясь результата запуска; результат проверяйте с помощью workflows_jobs. Manual-trigger workflow требует entity (и entity_id для конкретной записи), а payload - это JSON-объект, который шаги читают как $anythink.trigger.data.

Обновляет название или описание рабочего процесса. Меняются только название и описание; триггеры, шаги, группа и состояние включения возвращаются без изменений, и ни один инструмент здесь не правит триггер. Отказывается запускаться, пока существующий триггер неполный (например, триггер Timed без cron), и его сначала нужно исправить в панели управления. Для изменения шага используется workflows_step_update. Он изменяет или удаляет существующие данные, поэтому перед запуском нужно уточнить у пользователя.