Redmine

h1. Issue Relations

{{>toc}}

h2. /issues/:issue_id/relations

h3. POST

Creates a relation for the issue of given id (:issue_id).

+Parameters+:

* @relation@ (required): a hash of the relation attributes, including:

  * @issue_to_id@ (required): the id of the related issue

  * @relation_type@ (required): the type of relation (in: "relates", "duplicates", "duplicated", "blocks", "blocked", "precedes", "follows")

  * @delay@ (optional): the delay for a "precedes" or "follows" relation

+Response+:

  * @201 Created@: relation was created

  * @422 Unprocessable Entity@: relation was not created due to validation failures (response body contains the error messages)

h2. /issues/:issue_id/relations/:id

h3. GET

Returns the relation of given id.

+Response+:

<pre>

<?xml version="1.0" encoding="UTF-8"?>

<relation>

  <id>1819</id>

  <issue_id>8470</issue_id>

  <issue_to_id>8469</issue_to_id>

  <relation_type>relates</relation_type>

  <delay/>

</relation>

</pre>

h3. DELETE

Deletes the relation of given id.

+Response+:

  * @200 OK@: relation was deleted

  * @422 Unprocessable Entity@: relation was not deleted (response body contains the error messages)