Rest IssueRelations » History » Version 1

Version 1/9 - Next » - Current version
Jean-Philippe Lang, 2011-07-04 19:21


Issue Relations

/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)