Trello
Доски, списки и карточки Trello в процессах Pailot
Trello — доски, списки и карточки для задач. Блок читает и меняет их через API (Application Programming Interface — программный интерфейс).
С Trello в Pailot вы можете:
- Получать списки колонок на доске
- Читать карточки доски или одной колонки
- Создавать карточки: название, описание, метки, срок, позиция
- Обновлять карточку, переносить в другую колонку, архивировать
- Смотреть ленту действий доски или карточки
- Писать комментарии к карточке
Подключение — учётные данные Trello в блоке. В таблицах инструментов ключ не повторяется: он задаётся на уровне блока.
Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Секреты — в переменных окружения рабочего пространства.
Все списки (колонки) на доске.
| Параметр | Тип | Обязательный | Описание |
|---|
boardId | string | Да | ID доски |
| Параметр | Тип | Описание |
|---|
lists | array | Списки: id, name, closed, pos, idBoard |
count | number | Число списков |
Карточки на доске, опционально только из одной колонки.
| Параметр | Тип | Обязательный | Описание |
|---|
boardId | string | Да | ID доски |
listId | string | Нет | Фильтр по ID списка |
| Параметр | Тип | Описание |
|---|
cards | array | Карточки: id, name, desc, url, ID доски и списка, метки, срок |
count | number | Число карточек |
Новая карточка в списке.
| Параметр | Тип | Обязательный | Описание |
|---|
boardId | string | Да | ID доски |
listId | string | Да | ID списка, куда положить карточку |
name | string | Да | Название карточки |
desc | string | Нет | Описание |
pos | string | Нет | Позиция: top, bottom или положительное число |
due | string | Нет | Срок в формате ISO 8601 |
labels | string | Нет | ID меток через запятую |
| Параметр | Тип | Описание |
|---|
card | object | Созданная карточка: id, name, desc, url и остальные поля |
Обновление существующей карточки.
| Параметр | Тип | Обязательный | Описание |
|---|
cardId | string | Да | ID карточки |
name | string | Нет | Новое название |
desc | string | Нет | Новое описание |
closed | boolean | Нет | true — в архив, false — вернуть из архива |
idList | string | Нет | Перенести в другой список |
due | string | Нет | Срок в формате ISO 8601 |
dueComplete | boolean | Нет | Отметить срок выполненным |
| Параметр | Тип | Описание |
|---|
card | object | Обновлённая карточка: id, name, desc, url и остальные поля |
Лента действий доски или карточки. Нужен boardId или cardId.
| Параметр | Тип | Обязательный | Описание |
|---|
boardId | string | Нет | ID доски (нужен boardId или cardId) |
cardId | string | Нет | ID карточки (нужен boardId или cardId) |
filter | string | Нет | Типы действий (например commentCard,updateCard,createCard или all) |
limit | number | Нет | Максимум действий (по умолчанию 50, макс. 1000) |
| Параметр | Тип | Описание |
|---|
actions | array | Действия: type, date, member, data |
count | number | Число действий |
Комментарий к карточке.
| Параметр | Тип | Обязательный | Описание |
|---|
cardId | string | Да | ID карточки |
text | string | Да | Текст комментария |
| Параметр | Тип | Описание |
|---|
comment | object | Созданный комментарий: id, text, date и автор |