Project

General

Profile

Rest IssueRelations » History » Revision 5

Revision 4 (Máté Farkas, 2015-02-01 11:46) → Revision 5/10 (Sahya Norn, 2016-07-29 20:54)

h1. Issue Relations 

 {{>toc}} 

 h2. /issues/:issue_id/relations.:format 

 h3. GET 

 Returns the relations for the issue of given id (:issue_id). 

 +Example+: 

 <pre> 
 GET /issues/8470/relations.xml 
 </pre> 

 +Response+: 

 <pre> 
 <?xml version="1.0" encoding="UTF-8"?> 
 <relations type="array"> 
   <relation> 
     <id>1819</id> 
     <issue_id>8470</issue_id> 
     <issue_to_id>8469</issue_to_id> 
     <relation_type>relates</relation_type> 
     <delay/> 
   </relation> 
   <relation> 
     <id>1820</id> 
     <issue_id>8470</issue_id> 
     <issue_to_id>8467</issue_to_id> 
     <relation_type>relates</relation_type> 
     <delay/> 
   </relation> 
 </relations> 
 </pre> 

 Note: when getting an issue, relations can also be retrieved in a single request using @/issues/:id.:format?include=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 to explicit : default "relates"): (required): the type of relation (in: "relates", "duplicates", "duplicated", "blocks", "blocked", "precedes", "follows", "copied_to", "copied_from") 
   * @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. /relations/:id.:format 

 h3. GET 

 Returns the relation of given id. 

 +Example+: 

 <pre> 
 GET /relations/1819.xml 
 </pre> 

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