Linear — задачи и проекты для команд разработки: задачи, комментарии, циклы, метки, вложения и клиенты.
С Linear в Pailot вы можете:
- Читать, создавать, обновлять, архивировать и искать задачи; ставить метки
- Комментарии, проекты, команды, пользователи и состояния workflow (цепочка статусов)
- Циклы, вложения, связи задач и избранное
- Клиенты, запросы клиентов, статусы и уровни (tiers)
- Запускать процесс по вебхуку (входящему HTTP-запросу) Linear
Нужен вход по OAuth (вход по разрешению сервиса) Linear. Если сервис шлёт события, включите режим триггера и скопируйте URL вебхука. Не публикуйте URL.
Блок ставят на холст как отдельный шаг или прикрепляют к агенту.
Получить и отфильтровать задачи Linear
| Параметр | Тип | Обязательный | Описание |
|---|
teamId | string | Нет | ID команды Linear для фильтра |
projectId | string | Нет | ID проекта Linear для фильтра |
assigneeId | string | Нет | ID пользователя для фильтра по исполнителю |
stateId | string | Нет | ID состояния workflow для фильтра по статусу |
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) |
| Параметр | Тип | Описание |
|---|
issues | array | Массив filtered issues в Linear |
↳ id | string | ID задачи |
↳ title | string | Заголовок задачи |
↳ description | string | Описание задачи |
↳ priority | number | Приоритет задачи |
↳ estimate | number | Оценка задачи |
↳ url | string | URL задачи |
↳ dueDate | string | Срок (YYYY-MM-DD) |
↳ createdAt | string | Время создания |
↳ updatedAt | string | Время последнего обновления |
↳ state | object | Состояние задачи |
↳ assignee | object | Назначенный пользователь |
↳ teamId | string | ID команды |
↳ teamName | string | Имя команды |
↳ projectId | string | ID проекта |
↳ projectName | string | Название проекта |
↳ cycleId | string | ID цикла |
↳ cycleNumber | number | Номер цикла |
↳ cycleName | string | Имя цикла |
↳ labels | array | Метки задачи |
hasNextPage | boolean | Есть ли ещё результаты |
endCursor | string | Курсор следующей страницы |
Задача Linear по ID со всеми деталями
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи Linear |
| Параметр | Тип | Описание |
|---|
issue | object | Задача со всеми деталями |
↳ id | string | ID задачи |
↳ title | string | Заголовок задачи |
↳ description | string | Описание задачи |
↳ priority | number | Приоритет задачи (0–4) |
↳ estimate | number | Оценка задачи в поинтах |
↳ url | string | URL задачи |
↳ state | object | Состояние / статус задачи |
↳ assignee | object | Назначенный пользователь |
↳ labels | array | Метки задачи |
↳ createdAt | string | Время создания |
↳ updatedAt | string | Время последнего обновления |
Создать задачу в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
teamId | string | Да | ID команды Linear |
projectId | string | Нет | ID проекта Linear |
title | string | Да | Заголовок задачи |
description | string | Нет | Описание задачи |
stateId | string | Нет | ID состояния workflow (status) |
assigneeId | string | Нет | ID исполнителя задачи |
priority | number | Нет | Priority (0 — без приоритета, 1 — срочный, 2 — высокий, 3 — обычный, 4 — низкий) |
estimate | number | Нет | Оценка в поинтах |
labelIds | array | Нет | Массив ID меток задачи |
cycleId | string | Нет | ID цикла для задачи |
parentId | string | Нет | ID родительской задачи (для подзадач) |
dueDate | string | Нет | Срок в формате ISO 8601 (только дата: YYYY-MM-DD) |
subscriberIds | array | Нет | Массив ID наблюдателей задачи |
projectMilestoneId | string | Нет | ID вехи проекта для привязки к задаче |
| Параметр | Тип | Описание |
|---|
issue | object | Созданная задача со всеми свойствами |
↳ id | string | ID задачи |
↳ title | string | Заголовок задачи |
↳ description | string | Описание задачи |
↳ priority | number | Приоритет задачи |
↳ estimate | number | Оценка задачи |
↳ url | string | URL задачи |
↳ dueDate | string | Срок (YYYY-MM-DD) |
↳ state | object | Состояние задачи |
↳ assignee | object | Назначенный пользователь |
↳ teamId | string | ID команды |
↳ projectId | string | ID проекта |
↳ cycleId | string | ID цикла |
↳ cycleNumber | number | Номер цикла |
↳ cycleName | string | Имя цикла |
↳ parentId | string | ID родительской задачи |
↳ parentTitle | string | Заголовок родительской задачи |
↳ projectMilestoneId | string | ID вехи проекта |
↳ projectMilestoneName | string | Название вехи проекта |
↳ labels | array | Метки задачи |
Обновить задачу в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи Linear для обновления |
title | string | Нет | Новый заголовок задачи |
description | string | Нет | Новое описание задачи |
stateId | string | Нет | ID состояния workflow (status) |
assigneeId | string | Нет | ID исполнителя задачи |
priority | number | Нет | Priority (0 — без приоритета, 1 — срочный, 2 — высокий, 3 — обычный, 4 — низкий) |
estimate | number | Нет | Оценка в поинтах |
labelIds | array | Нет | Массив ID меток задачи (заменяет все текущие) |
projectId | string | Нет | ID проекта, куда перенести задачу |
cycleId | string | Нет | ID цикла для задачи |
parentId | string | Нет | ID родительской задачи (сделать подзадачей) |
dueDate | string | Нет | Срок в формате ISO 8601 (только дата: YYYY-MM-DD) |
addedLabelIds | array | Нет | Массив ID меток, которые добавить (без замены текущих) |
removedLabelIds | array | Нет | Массив ID меток, которые снять |
| Параметр | Тип | Описание |
|---|
issue | object | Обновлённая задача |
↳ id | string | ID задачи |
↳ title | string | Заголовок задачи |
↳ description | string | Описание задачи |
↳ priority | number | Приоритет задачи |
↳ estimate | number | Оценка задачи |
↳ state | object | Состояние задачи |
↳ assignee | object | Назначенный пользователь |
↳ labels | array | Метки задачи |
↳ updatedAt | string | Время последнего обновления |
↳ dueDate | string | Срок (YYYY-MM-DD) |
↳ projectId | string | ID проекта |
↳ cycleId | string | ID цикла |
↳ cycleNumber | number | Номер цикла |
↳ cycleName | string | Имя цикла |
↳ parentId | string | ID родительской задачи |
↳ parentTitle | string | Заголовок родительской задачи |
Архивировать задачу в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи Linear для архивации |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалась ли операция: archive |
issueId | string | ID заархивированной задачи |
Разархивировать задачу в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи Linear для разархивации |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалась ли операция: unarchive |
issueId | string | ID разархивированной задачи |
Удалить задачу в Linear (в корзину)
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи Linear для удаления |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалась ли операция: delete |
Полнотекстовый поиск задач в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
query | string | Да | Поисковый запрос string |
teamId | string | Нет | Фильтр по team ID |
includeArchived | boolean | Нет | Включить архивные задачи в поиск |
first | number | Нет | Число результатов (по умолчанию 50) |
| Параметр | Тип | Описание |
|---|
issues | array | Массив matching issues |
↳ id | string | ID задачи |
↳ title | string | Заголовок задачи |
↳ description | string | Описание задачи |
↳ priority | number | Приоритет задачи |
↳ state | object | Состояние задачи |
↳ assignee | object | Назначенный пользователь |
↳ labels | array | Метки задачи |
pageInfo | object | Данные постраничного вывода |
↳ hasNextPage | boolean | Есть ли ещё результаты |
↳ endCursor | string | Курсор следующей страницы |
Добавить метку к задаче в 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 | Текст комментария |
↳ createdAt | string | Время создания |
↳ user | object | Кто создал комментарий |
↳ issue | object | Связанная задача |
Изменить комментарий в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
commentId | string | Да | ID комментария для обновления |
body | string | Нет | Новый текст комментария (Markdown) |
| Параметр | Тип | Описание |
|---|
comment | object | Обновлённый комментарий |
↳ id | string | ID комментария |
↳ body | string | Текст комментария |
↳ updatedAt | string | Время последнего обновления |
↳ user | object | Кто создал комментарий |
Удалить комментарий в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
commentId | string | Да | ID комментария для удаления |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалась ли операция: delete |
Все комментарии задачи в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи Linear |
first | number | Нет | Число комментариев (по умолчанию 50) |
after | string | Нет | Курсор постраничного вывода |
| Параметр | Тип | Описание |
|---|
comments | array | Комментарии задачи |
↳ id | string | ID комментария |
↳ body | string | Текст комментария |
↳ createdAt | string | Время создания |
↳ updatedAt | string | Время последнего обновления |
↳ user | object | Кто создал комментарий |
pageInfo | object | Данные постраничного вывода |
↳ hasNextPage | boolean | Есть ли ещё результаты |
↳ endCursor | string | Курсор следующей страницы |
Список проектов Linear с необязательным фильтром
| Параметр | Тип | Обязательный | Описание |
|---|
teamId | string | Нет | Фильтр по team ID |
includeArchived | boolean | Нет | Включить архивные projects |
first | number | Нет | Число проектов (по умолчанию 50) |
after | string | Нет | Курсор постраничного вывода |
| Параметр | Тип | Описание |
|---|
projects | array | Массив projects |
↳ id | string | ID проекта |
↳ name | string | Название проекта |
↳ description | string | Описание проекта |
↳ state | string | Состояние проекта |
↳ priority | number | Приоритет проекта |
↳ lead | object | Руководитель проекта |
↳ teams | array | Команды проекта |
pageInfo | object | Данные постраничного вывода |
Проект Linear по ID
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта Linear |
| Параметр | Тип | Описание |
|---|
project | object | Проект со всеми деталями |
↳ id | string | ID проекта |
↳ name | string | Название проекта |
↳ description | string | Описание проекта |
↳ state | string | Состояние проекта |
↳ priority | number | Приоритет проекта |
↳ startDate | string | Дата начала |
↳ targetDate | string | Целевая дата завершения |
↳ lead | object | Руководитель проекта |
↳ teams | array | Связанные команды |
Создать проект в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
teamId | string | Да | ID команды, в которой создать проект |
name | string | Да | Название проекта |
description | string | Нет | Описание проекта |
leadId | string | Нет | ID руководителя проекта |
startDate | string | Нет | Дата начала проекта (ISO) |
targetDate | string | Нет | Целевая дата проекта (ISO) |
priority | number | Нет | Приоритет проекта (0–4) |
| Параметр | Тип | Описание |
|---|
project | object | Созданный проект |
↳ id | string | ID проекта |
↳ name | string | Название проекта |
↳ description | string | Описание проекта |
↳ state | string | Состояние проекта |
↳ priority | number | Приоритет проекта |
↳ lead | object | Руководитель проекта |
↳ teams | array | Связанные команды |
Обновить проект в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта для обновления |
name | string | Нет | Новое имя проекта |
description | string | Нет | Новое описание проекта |
state | string | Нет | Состояние проекта: planned, started, completed, canceled |
leadId | string | Нет | ID руководителя проекта |
startDate | string | Нет | Дата начала проекта (ISO: YYYY-MM-DD) |
targetDate | string | Нет | Целевая дата проекта (ISO: YYYY-MM-DD) |
priority | number | Нет | Приоритет проекта (0 — без приоритета, 1 — срочный, 2 — высокий, 3 — обычный, 4 — низкий) |
| Параметр | Тип | Описание |
|---|
project | object | Обновлённый проект |
↳ id | string | ID проекта |
↳ name | string | Название проекта |
↳ description | string | Описание проекта |
↳ state | string | Состояние проекта |
↳ priority | number | Приоритет проекта |
↳ startDate | string | Дата начала проекта |
↳ targetDate | string | Целевая дата проекта |
↳ lead | object | Руководитель проекта |
↳ teams | array | Связанные команды |
Архивировать проект в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта для архивации |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалась ли операция: archive |
projectId | string | ID заархивированного проекта |
Все пользователи workspace Linear
| Параметр | Тип | Обязательный | Описание |
|---|
includeDisabled | boolean | Нет | Включить отключённых пользователей |
first | number | Нет | Число пользователей (по умолчанию 50) |
after | string | Нет | Курсор постраничного вывода |
| Параметр | Тип | Описание |
|---|
users | array | Пользователи workspace |
↳ id | string | ID пользователя |
↳ name | string | Имя пользователя |
↳ email | string | Email пользователя |
↳ displayName | string | Отображаемое имя |
↳ active | boolean | Активен ли пользователь |
↳ admin | boolean | Администратор ли пользователь |
↳ avatarUrl | string | URL аватара |
pageInfo | object | Данные постраничного вывода |
Все команды workspace Linear
| Параметр | Тип | Обязательный | Описание |
|---|
first | number | Нет | Число команд (по умолчанию 50) |
after | string | Нет | Курсор постраничного вывода |
| Параметр | Тип | Описание |
|---|
teams | array | Массив teams |
↳ id | string | ID команды |
↳ name | string | Имя команды |
↳ key | string | Ключ команды (в идентификаторах задач) |
↳ description | string | Описание команды |
pageInfo | object | Данные постраничного вывода |
Данные текущего пользователя (viewer)
| Параметр | Тип | Обязательный | Описание |
|---|
| Параметр | Тип | Описание |
|---|
user | object | Текущий пользователь |
↳ id | string | ID пользователя |
↳ name | string | Имя пользователя |
↳ email | string | Email пользователя |
↳ displayName | string | Отображаемое имя |
↳ active | boolean | Активен ли пользователь |
↳ admin | boolean | Администратор ли пользователь |
↳ avatarUrl | string | URL аватара |
Все метки workspace или команды Linear
| Параметр | Тип | Обязательный | Описание |
|---|
teamId | string | Нет | Фильтр по team ID |
first | number | Нет | Число меток (по умолчанию 50) |
after | string | Нет | Курсор постраничного вывода |
| Параметр | Тип | Описание |
|---|
labels | array | Метки |
↳ id | string | ID метки |
↳ name | string | Имя метки |
↳ color | string | Цвет метки (hex) |
↳ description | string | Описание метки |
↳ team | object | Команда этой метки |
pageInfo | object | Данные постраничного вывода |
Создать метку в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
name | string | Да | Имя метки |
color | string | Нет | Цвет метки (hex, например "#ff0000") |
description | string | Нет | Описание метки |
teamId | string | Нет | ID команды (если пусто — метка workspace) |
| Параметр | Тип | Описание |
|---|
label | object | Созданная метка |
↳ id | string | ID метки |
↳ name | string | Имя метки |
↳ color | string | Цвет метки |
↳ description | string | Описание метки |
↳ team | object | Команда этой метки |
Обновить метку в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
labelId | string | Да | ID метки для обновления |
name | string | Нет | Новое имя метки |
color | string | Нет | Новый цвет метки (hex) |
description | string | Нет | Новое описание метки |
| Параметр | Тип | Описание |
|---|
label | object | Обновлённая метка |
↳ id | string | ID метки |
↳ name | string | Имя метки |
↳ color | string | Цвет метки |
↳ description | string | Описание метки |
Архивировать метку в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
labelId | string | Да | ID метки для архивации |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалась ли операция: archive |
labelId | string | ID заархивированной метки |
Все состояния workflow (статусы) в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
teamId | string | Нет | Фильтр по team ID |
first | number | Нет | Число состояний (по умолчанию 50) |
after | string | Нет | Курсор постраничного вывода |
| Параметр | Тип | Описание |
|---|
states | array | Состояния workflow |
↳ id | string | ID состояния |
↳ name | string | Имя состояния |
↳ type | string | Тип состояния |
↳ color | string | Цвет состояния |
↳ position | number | Позиция состояния в workflow |
↳ team | object | Команда этого состояния |
pageInfo | object | Данные постраничного вывода |
Создать состояние workflow (статус) в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
teamId | string | Да | ID команды для нового состояния |
name | string | Да | Имя состояния (например "In Review") |
color | string | Нет | Цвет состояния (hex) |
type | string | Да | Тип состояния: backlog, unstarted, started, completed или canceled |
description | string | Нет | Описание состояния |
position | number | Нет | Позиция в workflow |
| Параметр | Тип | Описание |
|---|
state | object | Созданное состояние workflow |
↳ id | string | ID состояния |
↳ name | string | Имя состояния |
↳ type | string | Тип состояния |
↳ color | string | Цвет состояния |
↳ position | number | Позиция состояния |
↳ team | object | Команда этого состояния |
Обновить состояние workflow в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
stateId | string | Да | ID состояния workflow для обновления |
name | string | Нет | Новое имя состояния |
color | string | Нет | Новый цвет состояния (hex) |
description | string | Нет | Новое описание состояния |
position | number | Нет | Новая позиция в workflow |
| Параметр | Тип | Описание |
|---|
state | object | Обновлённое состояние workflow |
↳ id | string | ID состояния |
↳ name | string | Имя состояния |
↳ type | string | Тип состояния |
↳ color | string | Цвет состояния |
↳ position | number | Позиция состояния |
Список циклов (спринты / итерации) в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
teamId | string | Нет | Фильтр по team ID |
first | number | Нет | Число циклов (по умолчанию 50) |
after | string | Нет | Курсор постраничного вывода |
| Параметр | Тип | Описание |
|---|
cycles | array | Массив cycles |
↳ id | string | ID цикла |
↳ number | number | Номер цикла |
↳ name | string | Имя цикла |
↳ startsAt | string | Дата начала |
↳ endsAt | string | Дата окончания |
↳ completedAt | string | Дата завершения |
↳ progress | number | Процент выполнения (0–1) |
↳ team | object | Команда этого цикла |
pageInfo | object | Данные постраничного вывода |
Цикл Linear по ID
| Параметр | Тип | Обязательный | Описание |
|---|
cycleId | string | Да | ID цикла |
| Параметр | Тип | Описание |
|---|
cycle | object | Цикл со всеми деталями |
↳ id | string | ID цикла |
↳ number | number | Номер цикла |
↳ name | string | Имя цикла |
↳ startsAt | string | Дата начала |
↳ endsAt | string | Дата окончания |
↳ progress | number | Процент выполнения |
↳ team | object | Команда этого цикла |
Создать цикл (спринт / итерацию) в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
teamId | string | Да | ID команды для нового цикла |
startsAt | string | Да | Cycle start date (формат ISO) |
endsAt | string | Да | Cycle end date (формат ISO) |
name | string | Нет | Имя цикла (необязательно; если не задано — сгенерируется само) |
| Параметр | Тип | Описание |
|---|
cycle | object | Созданный цикл |
↳ id | string | ID цикла |
↳ number | number | Номер цикла |
↳ name | string | Имя цикла |
↳ startsAt | string | Дата начала |
↳ endsAt | string | Дата окончания |
↳ team | object | Команда этого цикла |
Текущий активный цикл команды
| Параметр | Тип | Обязательный | Описание |
|---|
teamId | string | Да | ID команды |
| Параметр | Тип | Описание |
|---|
cycle | object | Активный цикл (null, если нет) |
↳ id | string | ID цикла |
↳ number | number | Номер цикла |
↳ name | string | Имя цикла |
↳ startsAt | string | Дата начала |
↳ endsAt | string | Дата окончания |
↳ progress | number | Процент выполнения |
↳ team | object | Команда этого цикла |
Добавить вложение к задаче в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи для вложения |
url | string | Да | URL вложения |
title | string | Да | Заголовок вложения |
subtitle | string | Нет | Подзаголовок / описание вложения |
| Параметр | Тип | Описание |
|---|
attachment | object | Созданное вложение |
↳ id | string | ID вложения |
↳ title | string | Заголовок вложения |
↳ subtitle | string | Подзаголовок вложения |
↳ url | string | URL вложения |
↳ createdAt | string | Время создания |
Все вложения задачи в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи |
first | number | Нет | Число вложений (по умолчанию 50) |
after | string | Нет | Курсор постраничного вывода |
| Параметр | Тип | Описание |
|---|
attachments | array | Массив attachments |
↳ id | string | ID вложения |
↳ title | string | Заголовок вложения |
↳ subtitle | string | Подзаголовок вложения |
↳ url | string | URL вложения |
↳ createdAt | string | Время создания |
pageInfo | object | Данные постраничного вывода |
Обновить метаданные вложения в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
attachmentId | string | Да | ID вложения для обновления |
title | string | Да | Новый заголовок вложения |
subtitle | string | Нет | Новый подзаголовок вложения |
| Параметр | Тип | Описание |
|---|
attachment | object | Обновлённое вложение |
↳ id | string | ID вложения |
↳ title | string | Заголовок вложения |
↳ subtitle | string | Подзаголовок вложения |
↳ url | string | URL вложения |
↳ updatedAt | string | Время последнего обновления |
Удалить вложение в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
attachmentId | string | Да | ID вложения для удаления |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалась ли операция: delete |
Связать две задачи в Linear (blocks, relates to, duplicates)
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID исходной задачи |
relatedIssueId | string | Да | ID целевой задачи для связи |
type | string | Да | Тип связи: blocks, duplicate или related. При blocks от A к B обратная связь (B blocked by A) создаётся сама |
| Параметр | Тип | Описание |
|---|
relation | object | Созданная связь задач |
↳ id | string | ID связи |
↳ type | string | Тип связи |
↳ issue | object | Исходная задача |
↳ relatedIssue | object | Целевая задача |
Все связи (зависимости) задачи в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Да | ID задачи |
first | number | Нет | Число связей (по умолчанию 50) |
after | string | Нет | Курсор постраничного вывода |
| Параметр | Тип | Описание |
|---|
relations | array | Связи задачи |
↳ id | string | ID связи |
↳ type | string | Тип связи |
↳ issue | object | Исходная задача |
↳ relatedIssue | object | Целевая задача |
pageInfo | object | Данные постраничного вывода |
Удалить связь между двумя задачами в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
relationId | string | Да | ID связи для удаления |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалась ли операция: delete |
Добавить в избранное задачу, проект, цикл или метку Linear
| Параметр | Тип | Обязательный | Описание |
|---|
issueId | string | Нет | ID задачи в избранное |
projectId | string | Нет | ID проекта в избранное |
cycleId | string | Нет | ID цикла в избранное |
labelId | string | Нет | ID метки в избранное |
| Параметр | Тип | Описание |
|---|
favorite | object | Созданное избранное |
↳ id | string | ID избранного |
↳ type | string | Тип избранного |
↳ issue | object | Задача в избранном (если есть) |
↳ project | object | Проект в избранном (если есть) |
↳ cycle | object | Цикл в избранном (если есть) |
Избранное текущего пользователя в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
first | number | Нет | Число избранного (по умолчанию 50) |
after | string | Нет | Курсор постраничного вывода |
| Параметр | Тип | Описание |
|---|
favorites | array | Массив favorited items |
↳ id | string | ID избранного |
↳ type | string | Тип избранного |
↳ issue | object | Задача в избранном |
↳ project | object | Проект в избранном |
↳ cycle | object | Цикл в избранном |
pageInfo | object | Данные постраничного вывода |
Опубликовать обновление статуса проекта в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта для публикации обновления |
body | string | Да | Текст обновления (Markdown) |
health | string | Нет | Здоровье проекта: onTrack, atRisk или offTrack |
| Параметр | Тип | Описание |
|---|
update | object | Созданное обновление проекта |
↳ id | string | ID обновления |
↳ body | string | Текст обновления |
↳ health | string | Состояние проекта |
↳ createdAt | string | Время создания |
↳ user | object | Кто создал обновление |
Все обновления статуса проекта в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта |
first | number | Нет | Число обновлений (по умолчанию 50) |
after | string | Нет | Курсор постраничного вывода |
| Параметр | Тип | Описание |
|---|
updates | array | Обновления проекта |
↳ id | string | ID обновления |
↳ body | string | Текст обновления |
↳ health | string | Состояние проекта |
↳ createdAt | string | Время создания |
↳ user | object | Кто создал обновление |
pageInfo | object | Данные постраничного вывода |
Уведомления текущего пользователя в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
first | number | Нет | Число уведомлений (по умолчанию 50) |
after | string | Нет | Курсор постраничного вывода |
| Параметр | Тип | Описание |
|---|
notifications | array | Массив notifications |
↳ id | string | ID уведомления |
↳ type | string | Тип уведомления |
↳ createdAt | string | Время создания |
↳ readAt | string | Время прочтения (null, если не прочитано) |
↳ issue | object | Связанная задача |
pageInfo | object | Данные постраничного вывода |
Отметить уведомление прочитанным или непрочитанным в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
notificationId | string | Да | ID уведомления для обновления |
readAt | string | Нет | Время прочтения (ISO). Передайте null или не указывайте — непрочитанное |
| Параметр | Тип | Описание |
|---|
notification | object | Обновлённое уведомление |
↳ id | string | ID уведомления |
↳ type | string | Тип уведомления |
↳ createdAt | string | Время создания |
↳ readAt | string | Время прочтения |
↳ issue | object | Связанная задача |
Создать клиента в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
name | string | Да | Имя клиента |
domains | array | Нет | Домены клиента |
externalIds | array | Нет | Внешние ID из других систем |
logoUrl | string | Нет | URL логотипа клиента |
ownerId | string | Нет | ID клиент |
revenue | number | Нет | Годовая выручка с клиента |
size | number | Нет | Размер организации клиента |
statusId | string | Нет | ID статуса клиента |
tierId | string | Нет | ID уровня клиента |
| Параметр | Тип | Описание |
|---|
customer | object | Созданный клиент |
↳ id | string | ID клиента |
↳ name | string | Имя клиента |
↳ domains | array | Связанные домены |
↳ externalIds | array | Внешние ID |
↳ logoUrl | string | URL логотипа |
↳ approximateNeedCount | number | Число customer needs |
↳ createdAt | string | Время создания |
↳ archivedAt | string | Время архивации (null, если не в архиве) |
Все клиенты в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
first | number | Нет | Число клиентов (по умолчанию 50) |
after | string | Нет | Курсор постраничного вывода |
includeArchived | boolean | Нет | Включить архивные customers (по умолчанию false) |
| Параметр | Тип | Описание |
|---|
customers | array | Массив customers |
↳ id | string | ID клиента |
↳ name | string | Имя клиента |
↳ domains | array | Связанные домены |
↳ externalIds | array | Внешние ID |
↳ logoUrl | string | URL логотипа |
↳ approximateNeedCount | number | Число customer needs |
↳ createdAt | string | Время создания |
↳ archivedAt | string | Время архивации (null, если не в архиве) |
pageInfo | object | Данные постраничного вывода |
Создать запрос клиента (need) в Linear. Привязка к клиенту, срочность (priority: 0 — неважно, 1 — важно), необязательная связь с задачей.
| Параметр | Тип | Обязательный | Описание |
|---|
customerId | string | Да | ID клиента для этого запроса |
body | string | Нет | Описание запроса клиента |
priority | number | Нет | Urgency level: 0 = Not important, 1 = Important (по умолчанию: 0) |
issueId | string | Нет | ID задачи для привязки запроса |
projectId | string | Нет | ID проекта для привязки запроса |
| Параметр | Тип | Описание |
|---|
customerNeed | object | Созданный запрос клиента |
↳ id | string | ID запроса клиента |
↳ body | string | Описание запроса |
↳ priority | number | Срочность (0 — неважно, 1 — важно) |
↳ createdAt | string | Время создания |
↳ updatedAt | string | Время последнего обновления |
↳ archivedAt | string | Время архивации (null, если не в архиве) |
↳ customer | object | Назначенный клиент |
↳ issue | object | Связанная задача (null, если нет) |
↳ project | object | Связанный проект (null, если нет) |
↳ creator | object | Кто создал запрос |
↳ url | string | URL запроса клиента |
Обновить запрос клиента (need) в Linear. Можно менять срочность, описание, клиента и связанную задачу.
| Параметр | Тип | Обязательный | Описание |
|---|
customerNeedId | string | Да | ID запроса клиента для обновления |
body | string | Нет | Обновлённое описание запроса клиента |
priority | number | Нет | Новая срочность: 0 — неважно, 1 — важно |
customerId | string | Нет | Новый ID клиента для этого запроса |
issueId | string | Нет | Новый ID задачи для привязки запроса |
projectId | string | Нет | Новый ID проекта для привязки запроса |
| Параметр | Тип | Описание |
|---|
customerNeed | object | Обновлённый запрос клиента |
↳ id | string | ID запроса клиента |
↳ body | string | Описание запроса |
↳ priority | number | Срочность (0 — неважно, 1 — важно) |
↳ createdAt | string | Время создания |
↳ updatedAt | string | Время последнего обновления |
↳ archivedAt | string | Время архивации (null, если не в архиве) |
↳ customer | object | Назначенный клиент |
↳ issue | object | Связанная задача (null, если нет) |
↳ project | object | Связанный проект (null, если нет) |
↳ creator | object | Кто создал запрос |
↳ url | string | URL запроса клиента |
Все запросы клиентов (needs) в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
first | number | Нет | Число запросов клиентов (по умолчанию 50) |
after | string | Нет | Курсор постраничного вывода |
includeArchived | boolean | Нет | Включить архивные customer requests (по умолчанию false) |
| Параметр | Тип | Описание |
|---|
customerNeeds | array | Массив customer requests |
↳ id | string | ID запроса клиента |
↳ body | string | Описание запроса |
↳ priority | number | Срочность (0 — неважно, 1 — важно) |
↳ createdAt | string | Время создания |
↳ updatedAt | string | Время последнего обновления |
↳ archivedAt | string | Время архивации (null, если не в архиве) |
↳ customer | object | Назначенный клиент |
↳ issue | object | Связанная задача (null, если нет) |
↳ project | object | Связанный проект (null, если нет) |
↳ creator | object | Кто создал запрос |
↳ url | string | URL запроса клиента |
pageInfo | object | Данные постраничного вывода |
Клиент Linear по ID
| Параметр | Тип | Обязательный | Описание |
|---|
customerId | string | Да | ID клиента |
| Параметр | Тип | Описание |
|---|
customer | object | Данные клиента |
↳ id | string | ID клиента |
↳ name | string | Имя клиента |
↳ domains | array | Связанные домены |
↳ externalIds | array | Внешние ID |
↳ logoUrl | string | URL логотипа |
↳ approximateNeedCount | number | Число customer needs |
↳ createdAt | string | Время создания |
↳ archivedAt | string | Время архивации (null, если не в архиве) |
Обновить клиента в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
customerId | string | Да | ID клиента для обновления |
name | string | Нет | Обновлённое имя клиента |
domains | array | Нет | Обновлённые домены |
externalIds | array | Нет | Обновлённые внешние ID |
logoUrl | string | Нет | Обновлённый URL логотипа |
ownerId | string | Нет | ID нового владельца |
revenue | number | Нет | Обновлённая годовая выручка |
size | number | Нет | Обновлённый размер организации |
statusId | string | Нет | ID обновлённого статуса клиента |
tierId | string | Нет | ID обновлённого уровня клиента |
| Параметр | Тип | Описание |
|---|
customer | object | Обновлённый клиент |
Удалить клиента в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
customerId | string | Да | ID клиента для удаления |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли удалить |
Слить двух клиентов в Linear: все данные переносятся с источника на цель
| Параметр | Тип | Обязательный | Описание |
|---|
sourceCustomerId | string | Да | ID исходного клиента (будет удалён после слияния) |
targetCustomerId | string | Да | ID целевого клиента (получит все данные) |
| Параметр | Тип | Описание |
|---|
customer | object | Целевой клиент после слияния |
Создать статус клиента в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
name | string | Да | Название статуса клиента |
color | string | Да | Цвет статуса (hex) |
displayName | string | Нет | Отображаемое имя статуса |
description | string | Нет | Описание статуса |
position | number | Нет | Позиция в списке статусов |
| Параметр | Тип | Описание |
|---|
customerStatus | object | Созданный статус клиента |
Обновить статус клиента в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
statusId | string | Да | ID статуса клиента для обновления |
name | string | Нет | Обновлённое имя статуса |
color | string | Нет | Обновлённый цвет статуса |
displayName | string | Нет | Обновлённое отображаемое имя |
description | string | Нет | Обновлённое описание |
position | number | Нет | Обновлённая позиция |
| Параметр | Тип | Описание |
|---|
customerStatus | object | Обновлённый статус клиента |
Удалить статус клиента в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
statusId | string | Да | ID статуса клиента для удаления |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли удалить |
Все статусы клиентов в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
| Параметр | Тип | Описание |
|---|
customerStatuses | array | Статусы клиентов |
Создать уровень клиента в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
name | string | Да | Название уровня клиента |
color | string | Да | Цвет уровня (hex) |
displayName | string | Нет | Отображаемое имя уровня |
description | string | Нет | Описание уровня |
position | number | Нет | Позиция в списке уровней |
| Параметр | Тип | Описание |
|---|
customerTier | object | Созданный уровень клиента |
Обновить уровень клиента в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
tierId | string | Да | ID уровня клиента для обновления |
name | string | Нет | Обновлённое имя уровня |
color | string | Нет | Обновлённый цвет уровня |
displayName | string | Нет | Обновлённое отображаемое имя |
description | string | Нет | Обновлённое описание |
position | number | Нет | Обновлённая позиция |
| Параметр | Тип | Описание |
|---|
customerTier | object | Обновлённый уровень клиента |
Удалить уровень клиента в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
tierId | string | Да | ID уровня клиента для удаления |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли удалить |
Все уровни клиентов в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
| Параметр | Тип | Описание |
|---|
customerTiers | array | Уровни клиентов |
Удалить проект в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта для удаления |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли удалить |
Создать метку проекта в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
name | string | Да | Название метки проекта |
color | string | Нет | Цвет метки (hex) |
description | string | Нет | Описание метки |
isGroup | boolean | Нет | Это группа меток |
parentId | string | Нет | ID родительской группы меток |
| Параметр | Тип | Описание |
|---|
projectLabel | object | Созданная метка проекта |
Обновить метку проекта в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
labelId | string | Да | ID метки проекта для обновления |
name | string | Нет | Обновлённое имя метки |
color | string | Нет | Обновлённый цвет метки |
description | string | Нет | Обновлённое описание |
| Параметр | Тип | Описание |
|---|
projectLabel | object | Обновлённая метка проекта |
Удалить метку проекта в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
labelId | string | Да | ID метки проекта для удаления |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли удалить |
Все метки проекта в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Нет | Необязательный ID проекта — фильтр меток этого проекта |
| Параметр | Тип | Описание |
|---|
projectLabels | array | Метки проекта |
Добавить метку к проекту в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта |
labelId | string | Да | ID метки для добавления |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли добавить метку |
projectId | string | ID проект |
Снять метку с проекта в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта |
labelId | string | Да | ID метки для снятия |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли снять метку |
projectId | string | ID проект |
Создать веху проекта в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта |
name | string | Да | Название вехи |
description | string | Нет | Описание вехи |
targetDate | string | Нет | Целевая дата (ISO 8601) |
| Параметр | Тип | Описание |
|---|
projectMilestone | object | Созданная веха проекта |
Обновить веху проекта в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
milestoneId | string | Да | ID вехи проекта для обновления |
name | string | Нет | Обновлённое имя вехи |
description | string | Нет | Обновлённое описание |
targetDate | string | Нет | Новая целевая дата (ISO 8601) |
| Параметр | Тип | Описание |
|---|
projectMilestone | object | Обновлённая веха проекта |
Удалить веху проекта в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
milestoneId | string | Да | ID вехи проекта для удаления |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли удалить |
Все вехи проекта в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта для списка вех |
| Параметр | Тип | Описание |
|---|
projectMilestones | array | Вехи проекта |
Создать статус проекта в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
name | string | Да | Название статуса проекта |
type | string | Да | Тип статуса: backlog, planned, started, paused, completed или canceled |
color | string | Да | Цвет статуса (hex) |
position | number | Да | Позиция в списке статусов (например 0, 1, 2...) |
description | string | Нет | Описание статуса |
indefinite | boolean | Нет | Бессрочный ли статус |
| Параметр | Тип | Описание |
|---|
projectStatus | object | Созданный статус проекта |
Обновить статус проекта в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
statusId | string | Да | ID статуса проекта для обновления |
name | string | Нет | Обновлённое имя статуса |
color | string | Нет | Обновлённый цвет статуса |
description | string | Нет | Обновлённое описание |
indefinite | boolean | Нет | Обновлённый флаг бессрочности |
position | number | Нет | Обновлённая позиция |
| Параметр | Тип | Описание |
|---|
projectStatus | object | Обновлённый статус проекта |
Удалить статус проекта в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
statusId | string | Да | ID статуса проекта для удаления |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли удалить |
Все статусы проекта в Linear
| Параметр | Тип | Обязательный | Описание |
|---|
| Параметр | Тип | Описание |
|---|
projectStatuses | array | Статусы проекта |
