Связать задачи

Запрос позволяет создать связь между двумя задачами. Связь создается между текущей задачей (указывается в параметре issue-id запроса) и связываемой (указывается в поле issue тела запроса).

Формат запроса

Для создания связи используйте HTTP-запрос с методом POST:

POST /v2/issues/<issue-id>/links?

Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-Id: <идентификатор организации>

{
    "relationship": "<тип связи>",
    "issue": "<задача>"
}'

Параметры запроса

<issue-id>: Идентификатор или ключ текущей задачи.

Параметры, передаваемые в теле запроса


Параметр	Описание	Формат
`relationship`	Тип связи между задачами: `relates` — простая связь. `is dependent by` — текущая задача является блокером. `depends on` — текущая задача зависит от связываемой `is subtask for` — текущая задача является подзадачей связываемой. `is parent task for` — текущая задача является родительской для связываемой задачи. `duplicates` — текущая задача дублирует связываемую. `is duplicated by` — связываемая задача дублирует текущую. `is epic of` — текущая задача является эпиком связываемой. Связь такого типа можно установить только для задач типа "Эпик". `has epic` — связываемая задача является эпиком текущей. Связь такого типа можно установить только для задач типа "Эпик".	Строка
`issue`	Идентификатор или ключ связываемой задачи.	Строка


Параметр	Описание	Формат
`relationship`	Тип связи между задачами: `relates` — простая связь. `is dependent by` — текущая задача является блокером. `depends on` — текущая задача зависит от связываемой `is subtask for` — текущая задача является подзадачей связываемой. `is parent task for` — текущая задача является родительской для связываемой задачи. `duplicates` — текущая задача дублирует связываемую. `is duplicated by` — связываемая задача дублирует текущую. `is epic of` — текущая задача является эпиком связываемой. Связь такого типа можно установить только для задач типа "Эпик". `has epic` — связываемая задача является эпиком текущей. Связь такого типа можно установить только для задач типа "Эпик".	Строка
`issue`	Идентификатор или ключ связываемой задачи.	Строка

Создание связи:

Используется HTTP-метод POST.

POST /v2/issues/TEST-1/?links HTTP/1.1
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-Id: <идентификатор организации>
Cache-Control: no-cache

{
    "relationship": "relates",
    "issue": "TREK-2"
}

Формат ответа

{
  "self" : "https://api.tracker.yandex.net/v2/issues/TEST-1/links/1048570",
  "id" : 1048570,
  "type" : {
    "self" : "https://api.tracker.yandex.net/v2/linktypes/relates",
    "id" : "relates",
    "inward" : "relates",
    "outward" : "relates"
  },
  "direction" : "inward",
  "object" : {
    "self" : "https://api.tracker.yandex.net/v2/issues/STARTREK-2",
    "id" : "4ff3e8dae4b0e2ac27f6eb43",
    "key" : "TREK-2",
    "display" : "NEW!!!"
  },
  "createdBy" : {
    "self" : "https://api.tracker.yandex.net/v2/users/1120000000004859",
    "id": "<id сотрудника>",
    "display": "<отображаемое имя сотрудника>"
  },
  "updatedBy" : {
    "self": "https://api.tracker.yandex.net/v2/users/1120000000049224",
    "id": "<id сотрудника>",
    "display": "<отображаемое имя сотрудника>"
  },
  "createdAt" : "2014-06-18T12:06:02.401+0000",
  "updatedAt" : "2014-06-18T12:06:02.401+0000"
}

Параметры ответа


Параметр	Описание	Тип данных
self	Адрес ресурса API, который содержит информацию о связи.	Строка.
id	Идентификатор связи.	Число.
type	Блок с информацией о типе связи.	Объект.
direction	Тип связи задачи, указанной в запросе, по отношению к задаче в поле object . Возможны следующие значения: `outward` — задача, указанная в запросе, является основной для задачи в поле object. `inward` — задача в поле object является основной для задачи, указанной в запросе.	Строка.
object	Блок с информацией о связанной задаче.	Объект.
createdBy	Блок с информацией о создателе связи.	Объект.
updatedBy	Блок с информацией о последнем изменившем связанную задачу пользователе.	Объект.
createdAt	Дата и время создания связи.	Строка.
updatedAt	Дата и время изменения связи.	Строка.
assignee	Исполнитель связанной задачи.	Объект.
status	Статус связанной задачи.	Объект.
Поля объекта `type`
self	Ссылка на тип связи.	Строка.
id	Идентификатор типа связи.	Строка.
inward	Название типа связи задачи в поле object по отношению к задаче, указанной в запросе.	Строка.
outward	Название типа связи задачи, указанной в запросе, по отношению к задаче в поле object.	Строка.
Поля объекта `object`
`self`	Адрес ресурса API, который содержит информацию о задаче.	Строка.
`id`	Идентификатор задачи.	Строка.
`key`	Ключ задачи.	Строка
display	Отображаемое название задачи.	Строка.
Поля объекта `createdBy`
`self`	Ссылка на пользователя Трекера.	Строка.
`id`	Идентификатор пользователя.	Строка.
`display`	Отображаемое имя пользователя.	Строка.
Поля объекта `updatedBy`
`self`	Ссылка на пользователя Трекера.	Строка.
`id`	Идентификатор пользователя.	Строка.
`display`	Отображаемое имя пользователя.	Строка.
Поля объекта `assignee`
`self`	Ссылка на пользователя Трекера.	Строка.
`id`	Идентификатор пользователя.	Строка.
`display`	Отображаемое имя пользователя.	Строка.
Поля объекта `status`
`self`	Ссылка на статус.	Строка.
`id`	Идентификатор статуса.	Строка.
`key`	Ключ статуса.	Строка.
`display`	Отображаемое название статуса.	Строка.


Параметр	Описание	Тип данных
self	Адрес ресурса API, который содержит информацию о связи.	Строка.
id	Идентификатор связи.	Число.
type	Блок с информацией о типе связи.	Объект.
direction	Тип связи задачи, указанной в запросе, по отношению к задаче в поле object . Возможны следующие значения: `outward` — задача, указанная в запросе, является основной для задачи в поле object. `inward` — задача в поле object является основной для задачи, указанной в запросе.	Строка.
object	Блок с информацией о связанной задаче.	Объект.
createdBy	Блок с информацией о создателе связи.	Объект.
updatedBy	Блок с информацией о последнем изменившем связанную задачу пользователе.	Объект.
createdAt	Дата и время создания связи.	Строка.
updatedAt	Дата и время изменения связи.	Строка.
assignee	Исполнитель связанной задачи.	Объект.
status	Статус связанной задачи.	Объект.
Поля объекта `type`
self	Ссылка на тип связи.	Строка.
id	Идентификатор типа связи.	Строка.
inward	Название типа связи задачи в поле object по отношению к задаче, указанной в запросе.	Строка.
outward	Название типа связи задачи, указанной в запросе, по отношению к задаче в поле object.	Строка.
Поля объекта `object`
`self`	Адрес ресурса API, который содержит информацию о задаче.	Строка.
`id`	Идентификатор задачи.	Строка.
`key`	Ключ задачи.	Строка
display	Отображаемое название задачи.	Строка.
Поля объекта `createdBy`
`self`	Ссылка на пользователя Трекера.	Строка.
`id`	Идентификатор пользователя.	Строка.
`display`	Отображаемое имя пользователя.	Строка.
Поля объекта `updatedBy`
`self`	Ссылка на пользователя Трекера.	Строка.
`id`	Идентификатор пользователя.	Строка.
`display`	Отображаемое имя пользователя.	Строка.
Поля объекта `assignee`
`self`	Ссылка на пользователя Трекера.	Строка.
`id`	Идентификатор пользователя.	Строка.
`display`	Отображаемое имя пользователя.	Строка.
Поля объекта `status`
`self`	Ссылка на статус.	Строка.
`id`	Идентификатор статуса.	Строка.
`key`	Ключ статуса.	Строка.
`display`	Отображаемое название статуса.	Строка.

Возможные коды ответа

404: Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта.