Linear
Взаимодействие с задачами, проектами и другими элементами Linear
Linear — это современная платформа для управления проектами и отслеживания задач, которая помогает командам планировать, отслеживать и управлять своей работой с помощью оптимизированного интерфейса. Linear поддерживает гибкие методологии с настраиваемыми рабочими процессами, циклами и вехами проектов.
С интеграцией Linear в AACFlow вы можете:
- Управлять задачами: Создавать, читать, обновлять, искать, архивировать, разархивировать и удалять задачи
- Управлять метками: Добавлять или удалять метки из задач, а также создавать, обновлять или архивировать метки
- Комментировать задачи: Создавать, обновлять, удалять и перечислять комментарии к задачам
- Управлять проектами: Перечислять, получать, создавать, обновлять, архивировать и удалять проекты с вехами, метками и статусами
- Отслеживать циклы: Перечислять, получать и создавать циклы, а также получать активный цикл
- Работать с вложениями: Создавать, перечислять, обновлять и удалять вложения в задачах
- Управлять связями задач: Создавать, перечислять и удалять связи между задачами
- Получать доступ к данным команды: Перечислять пользователей, команды, состояния рабочих процессов, уведомления и избранное
- Управлять клиентами: Создавать, обновлять, удалять, перечислять и объединять клиентов со статусами, уровнями и запросами
В AACFlow интеграция с Linear позволяет вашим агентам взаимодействовать с рабочим процессом управления проектами в рамках автоматизированных процессов. Агенты могут создавать задачи из внешних триггеров, обновлять статусы, управлять проектами и циклами, а также синхронизировать данные — обеспечивая интеллектуальную автоматизацию управления проектами в масштабе.
Интегрируйте Linear в рабочий процесс. Может управлять задачами, комментариями, проектами, метками, состояниями рабочих процессов, циклами, вложениями и многим другим. Также может запускать рабочие процессы на основе событий веб-хуков Linear.
Получить и отфильтровать задачи из Linear
| Параметр | Тип | Обязательный | Описание |
|---|
teamId | string | Нет | ID команды Linear (формат UUID) для фильтрации задач по команде |
projectId | string | Нет | ID проекта Linear (формат UUID) для фильтрации задач по проекту |
assigneeId | string | Нет | ID пользователя для фильтрации по исполнителю |
stateId | string | Нет | ID состояния рабочего процесса для фильтрации по статусу |
priority | number | Нет | Приоритет для фильтрации (0=Без приоритета, 1=Срочный, 2=Высокий, 3=Нормальный, 4=Низкий) |
labelIds | array | Нет | Массив ID меток для фильтрации |
createdAfter | string | Нет | Фильтровать задачи, созданные после этой даты (формат ISO 8601) |
updatedAfter | string | Нет | Фильтровать задачи, обновленные после этой даты (формат ISO 8601) |
includeArchived | boolean | Нет | Включать архивированные задачи (по умолчанию: false) |
first | number | Нет | Количество задач для возврата (по умолчанию: 50, максимум: 250) |
after | string | Нет | Курсор пагинации для следующей страницы |
orderBy | string | Нет | Порядок сортировки: "createdAt" или "updatedAt" (по умолчанию: "updatedAt") |
| Параметр | Тип | Описание |
|---|
hasNextPage | boolean | Есть ли еще результаты |
endCursor | string | Курсор для следующей страницы |
issues | array | Массив отфильтрованных задач из Linear |
↳ id | string | ID задачи |
↳ title | string | Заголовок задачи |
↳ description | string | Описание задачи |
↳ priority | number | Приоритет (0=Без приоритета, 1=Срочный, 2=Высокий, 3=Нормальный, 4=Низкий) |
↳ estimate | number | Оценка в баллах |
↳ url | string | URL задачи |
↳ dueDate | string | Срок выполнения (ГГГГ-ММ-ДД) |
↳ createdAt | string | Временная метка создания (ISO 8601) |
↳ updatedAt | string | Временная метка последнего обновления (ISO 8601) |
↳ archivedAt | string | Временная метка архивации (ISO 8601) |
↳ state | object | Состояние рабочего процесса/статус |
↳ id | string | ID состояния |
↳ name | string | Название состояния (например, "К выполнению", "В работе") |
↳ type | string | Тип состояния (unstarted, started, completed, canceled) |
↳ assignee | object | Объект пользователя |
↳ id | string | ID пользователя |
↳ name | string | Имя пользователя |
↳ email | string | Email пользователя |
↳ teamId | string | ID команды |
↳ teamName | string | Название команды |
↳ projectId | string | ID проекта |
↳ projectName | string | Название проекта |
↳ cycleId | string | ID цикла |
↳ cycleNumber | number | Номер цикла |
↳ cycleName | string | Название цикла |
↳ labels | array | Метки задачи |
↳ id | string | ID метки |
↳ name | string | Название метки |
↳ color | string | Цвет метки (hex) |
Получить одну задачу по ID из Linear с полными деталями
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи Linear |
| Параметр | Тип | Описание |
|---|
issue | object | Задача с полными деталями |
↳ id | string | ID задачи |
↳ title | string | Заголовок задачи |
↳ description | string | Описание задачи |
↳ priority | number | Приоритет (0=Без приоритета, 1=Срочный, 2=Высокий, 3=Нормальный, 4=Низкий) |
↳ estimate | number | Оценка в баллах |
↳ url | string | URL задачи |
↳ dueDate | string | Срок выполнения (ГГГГ-ММ-ДД) |
↳ createdAt | string | Временная метка создания (ISO 8601) |
↳ updatedAt | string | Временная метка последнего обновления (ISO 8601) |
↳ completedAt | string | Временная метка завершения (ISO 8601) |
↳ canceledAt | string | Временная метка отмены (ISO 8601) |
↳ archivedAt | string | Временная метка архивации (ISO 8601) |
↳ state | object | Состояние рабочего процесса/статус |
↳ id | string | ID состояния |
↳ name | string | Название состояния (например, "К выполнению", "В работе") |
↳ type | string | Тип состояния (unstarted, started, completed, canceled) |
↳ assignee | object | Объект пользователя |
↳ id | string | ID пользователя |
↳ name | string | Имя пользователя |
↳ email | string | Email пользователя |
↳ teamId | string | ID команды |
↳ projectId | string | ID проекта |
↳ labels | array | Метки задачи |
↳ id | string | ID метки |
↳ name | string | Название метки |
↳ color | string | Цвет метки (hex) |
Создать новую задачу в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
teamId | string | Да | ID команды Linear (формат UUID), в которой будет создана задача |
projectId | string | Нет | ID проекта Linear (формат UUID) для связи с задачей |
title | string | Да | Заголовок задачи |
description | string | Нет | Описание задачи |
stateId | string | Нет | ID состояния рабочего процесса (статус) |
assigneeId | string | Нет | ID пользователя для назначения задачи |
priority | number | Нет | Приоритет (0=Без приоритета, 1=Срочный, 2=Высокий, 3=Нормальный, 4=Низкий) |
estimate | number | Нет | Оценка в баллах |
labelIds | array | Нет | Массив ID меток для установки на задаче |
cycleId | string | Нет | ID цикла для назначения задачи |
parentId | string | Нет | ID родительской задачи (для создания подзадач) |
dueDate | string | Нет | Срок выполнения в формате ISO 8601 (только дата: ГГГГ-ММ-ДД) |
subscriberIds | array | Нет | Массив ID пользователей для подписки на задачу |
projectMilestoneId | string | Нет | ID вехи проекта для связи с задачей |
| Параметр | Тип | Описание |
|---|
issue | object | Созданная задача со всеми ее свойствами |
↳ id | string | ID задачи |
↳ title | string | Заголовок задачи |
↳ description | string | Описание задачи |
↳ priority | number | Приоритет (0=Без приоритета, 1=Срочный, 2=Высокий, 3=Нормальный, 4=Низкий) |
↳ estimate | number | Оценка в баллах |
↳ url | string | URL задачи |
↳ dueDate | string | Срок выполнения (ГГГГ-ММ-ДД) |
↳ createdAt | string | Временная метка создания (ISO 8601) |
↳ updatedAt | string | Временная метка последнего обновления (ISO 8601) |
↳ completedAt | string | Временная метка завершения (ISO 8601) |
↳ canceledAt | string | Временная метка отмены (ISO 8601) |
↳ archivedAt | string | Временная метка архивации (ISO 8601) |
↳ state | object | Состояние рабочего процесса/статус |
↳ id | string | ID состояния |
↳ name | string | Название состояния (например, "К выполнению", "В работе") |
↳ type | string | Тип состояния (unstarted, started, completed, canceled) |
↳ assignee | object | Объект пользователя |
↳ id | string | ID пользователя |
↳ name | string | Имя пользователя |
↳ email | string | Email пользователя |
↳ teamId | string | ID команды |
↳ projectId | string | ID проекта |
↳ labels | array | Метки задачи |
↳ id | string | ID метки |
↳ name | string | Название метки |
↳ color | string | Цвет метки (hex) |
↳ cycleId | string | ID цикла |
↳ cycleNumber | number | Номер цикла |
↳ cycleName | string | Название цикла |
↳ parentId | string | ID родительской задачи |
↳ parentTitle | string | Заголовок родительской задачи |
↳ projectMilestoneId | string | ID вехи проекта |
↳ projectMilestoneName | string | Название вехи проекта |
Обновить существующую задачу в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи Linear для обновления |
title | string | Нет | Новый заголовок задачи |
description | string | Нет | Новое описание задачи |
stateId | string | Нет | ID состояния рабочего процесса (статус) |
assigneeId | string | Нет | ID пользователя для назначения задачи |
priority | number | Нет | Приоритет (0=Без приоритета, 1=Срочный, 2=Высокий, 3=Нормальный, 4=Низкий) |
estimate | number | Нет | Оценка в баллах |
labelIds | array | Нет | Массив ID меток для установки на задаче (заменяет все существующие метки) |
projectId | string | Нет | ID проекта для перемещения задачи |
cycleId | string | Нет | ID цикла для назначения задачи |
parentId | string | Нет | ID родительской задачи (для создания подзадачи) |
dueDate | string | Нет | Срок выполнения в формате ISO 8601 (только дата: ГГГГ-ММ-ДД) |
addedLabelIds | array | Нет | Массив ID меток для добавления к задаче (без замены существующих меток) |
removedLabelIds | array | Нет | Массив ID меток для удаления из задачи |
| Параметр | Тип | Описание |
|---|
issue | object | Обновленная задача |
↳ id | string | ID задачи |
↳ title | string | Заголовок задачи |
↳ description | string | Описание задачи |
↳ priority | number | Приоритет (0=Без приоритета, 1=Срочный, 2=Высокий, 3=Нормальный, 4=Низкий) |
↳ estimate | number | Оценка в баллах |
↳ url | string | URL задачи |
↳ dueDate | string | Срок выполнения (ГГГГ-ММ-ДД) |
↳ createdAt | string | Временная метка создания (ISO 8601) |
↳ updatedAt | string | Временная метка последнего обновления (ISO 8601) |
↳ completedAt | string | Временная метка завершения (ISO 8601) |
↳ canceledAt | string | Временная метка отмены (ISO 8601) |
↳ archivedAt | string | Временная метка архивации (ISO 8601) |
↳ state | object | Состояние рабочего процесса/статус |
↳ id | string | ID состояния |
↳ name | string | Название состояния (например, "К выполнению", "В работе") |
↳ type | string | Тип состояния (unstarted, started, completed, canceled) |
↳ assignee | object | Объект пользователя |
↳ id | string | ID пользователя |
↳ name | string | Имя пользователя |
↳ email | string | Email пользователя |
↳ teamId | string | ID команды |
↳ projectId | string | ID проекта |
↳ labels | array | Метки задачи |
↳ id | string | ID метки |
↳ name | string | Название метки |
↳ color | string | Цвет метки (hex) |
↳ cycleId | string | ID цикла |
↳ cycleNumber | number | Номер цикла |
↳ cycleName | string | Название цикла |
↳ parentId | string | ID родительской задачи |
↳ parentTitle | string | Заголовок родительской задачи |
↳ projectMilestoneId | string | ID вехи проекта |
↳ projectMilestoneName | string | Название вехи проекта |
Архивировать задачу в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи Linear для архивации |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешна ли операция архивации |
issueId | string | ID архивированной задачи |
Разархивировать (восстановить) архивированную задачу в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи Linear для разархивации |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешна ли операция разархивации |
issueId | string | ID разархивированной задачи |
Удалить (переместить в корзину) задачу в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи Linear для удаления |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешна ли операция удаления |
Искать задачи в Linear с использованием полнотекстового поиска
| Параметр | Тип | Обязательный | Описание |
|---|
query | string | Да | Строка поискового запроса |
teamId | string | Нет | Фильтр по ID команды |
includeArchived | boolean | Нет | Включать архивированные задачи в результаты поиска |
first | number | Нет | Количество результатов для возврата (по умолчанию: 50) |
after | string | Нет | Курсор для пагинации |
| Параметр | Тип | Описание |
|---|
pageInfo | object | Информация о пагинации |
↳ hasNextPage | boolean | Есть ли еще результаты |
↳ endCursor | string | Курсор для следующей страницы |
issues | array | Массив соответствующих задач |
↳ id | string | ID задачи |
↳ title | string | Заголовок задачи |
↳ description | string | Описание задачи |
↳ priority | number | Приоритет (0=Без приоритета, 1=Срочный, 2=Высокий, 3=Нормальный, 4=Низкий) |
↳ estimate | number | Оценка в баллах |
↳ url | string | URL задачи |
↳ dueDate | string | Срок выполнения (ГГГГ-ММ-ДД) |
↳ createdAt | string | Временная метка создания (ISO 8601) |
↳ updatedAt | string | Временная метка последнего обновления (ISO 8601) |
↳ completedAt | string | Временная метка завершения (ISO 8601) |
↳ canceledAt | string | Временная метка отмены (ISO 8601) |
↳ archivedAt | string | Временная метка архивации (ISO 8601) |
↳ state | object | Состояние рабочего процесса/статус |
↳ id | string | ID состояния |
↳ name | string | Название состояния (например, "К выполнению", "В работе") |
↳ type | string | Тип состояния (unstarted, started, completed, canceled) |
↳ assignee | object | Объект пользователя |
↳ id | string | ID пользователя |
↳ name | string | Имя пользователя |
↳ email | string | Email пользователя |
↳ teamId | string | ID команды |
↳ projectId | string | ID проекта |
↳ labels | array | Метки задачи |
↳ id | string | ID метки |
↳ name | string | Название метки |
↳ color | string | Цвет метки (hex) |
Добавить метку к задаче в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи Linear |
labelId | string | Да | ID метки для добавления к задаче |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешно ли добавлена метка |
issueId | string | ID задачи |
Удалить метку из задачи в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи Linear |
labelId | string | Да | ID метки для удаления из задачи |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешно ли удалена метка |
issueId | string | ID задачи |
Добавить комментарий к задаче в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи Linear для комментирования |
body | string | Да | Текст комментария (поддерживает Markdown) |
| Параметр | Тип | Описание |
|---|
comment | object | Созданный комментарий |
↳ id | string | ID комментария |
↳ body | string | Текст комментария (Markdown) |
↳ createdAt | string | Временная метка создания (ISO 8601) |
↳ updatedAt | string | Временная метка последнего обновления (ISO 8601) |
↳ user | object | Объект пользователя |
↳ id | string | ID пользователя |
↳ name | string | Имя пользователя |
↳ email | string | Email пользователя |
↳ issue | object | Объект задачи |
↳ id | string | ID задачи |
↳ title | string | Заголовок задачи |
| Параметр | Тип | Описание |
|---|
comment | object | Созданный комментарий |
↳ id | string | ID комментария |
↳ body | string | Текст комментария (Markdown) |
↳ createdAt | string | Временная метка создания (ISO 8601) |
↳ updatedAt | string | Временная метка последнего обновления (ISO 8601) |
↳ user | object | Объект пользователя |
↳ id | string | ID пользователя |
↳ name | string | Имя пользователя |
↳ email | string | Email пользователя |
↳ issue | object | Объект задачи |
↳ id | string | ID задачи |
↳ title | string | Заголовок задачи |
Редактировать комментарий в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
commentId | string | Да | ID комментария для обновления |
body | string | Нет | Новый текст комментария (поддерживает Markdown) |
| Параметр | Тип | Описание |
|---|
comment | object | Обновленный комментарий |
↳ id | string | ID комментария |
↳ body | string | Текст комментария (Markdown) |
↳ createdAt | string | Временная метка создания (ISO 8601) |
↳ updatedAt | string | Временная метка последнего обновления (ISO 8601) |
↳ user | object | Объект пользователя |
↳ id | string | ID пользователя |
↳ name | string | Имя пользователя |
↳ email | string | Email пользователя |
↳ issue | object | Объект задачи |
↳ id | string | ID задачи |
↳ title | string | Заголовок задачи |
Удалить комментарий из Linear
| Параметр | Тип | Обязательный | Описание |
|---|
commentId | string | Да | ID комментария для удаления |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешна ли операция удаления |
Перечислить все комментарии к задаче в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи Linear |
first | number | Нет | Количество комментариев для возврата (по умолчанию: 50) |
after | string | Нет | Курсор для пагинации |
| Параметр | Тип | Описание |
|---|
pageInfo | object | Информация о пагинации |
↳ hasNextPage | boolean | Есть ли еще результаты |
↳ endCursor | string | Курсор для следующей страницы |
comments | array | Массив комментариев к задаче |
↳ id | string | ID комментария |
↳ body | string | Текст комментария (Markdown) |
↳ createdAt | string | Временная метка создания (ISO 8601) |
↳ updatedAt | string | Временная метка последнего обновления (ISO 8601) |
↳ user | object | Объект пользователя |
↳ id | string | ID пользователя |
↳ name | string | Имя пользователя |
↳ email | string | Email пользователя |
↳ issue | object | Объект задачи |
↳ id | string | ID задачи |
