Issue Relations¶

• Table of contents
• Issue Relations
  • /issues/:issue_id/relations
    • POST
  • /issues/:issue_id/relations/:id
    • GET
    • DELETE

/issues/:issue_id/relations¶

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)

/issues/:issue_id/relations/:id¶

GET¶

Returns the relation of given id.

Response:

<?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>

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)