====/api/asset/relate [GET]====

===Usage===

Returns a list of all relationships that pass through a given asset.

While you can request these values for grandchildren and great-grandchildren etc. using the **indirect** argument, we normally suggest using the more targeted [[/api/asset/before]] and [[/api/asset/after]] functions.

===Details==

^Detail^Value^
|Group|Asset|
|From Server Version|0.9.0|
|Permission|[[permission_guest|Guest]]|
|Methods|GET|

==Parameters==

^Parameter^Notes^Meaning^
|**id**|Integer [Required]|The [[assetid|ID of the asset]]|
|**indirect**|Boolean (0)|Set to '1' to return recursive results (all grandchildren etc. This may have a negative performance impact.)|
|**format**|String (xml)|Either 'xml' or 'json'|

===Examples===

==Call==

<code>
[GET] http://ardiserver.com/api/asset/relate?id=925
</code>

==Success (XML)==

<code>
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
   <relatedto rel="2" asset="5" name="Showroom Floor" dir="up"/>
   <relatedto rel="2" asset="9" name="Front Left Wheel" dir="down"/>
   <relatedto rel="2" asset="10" name="Front Right Wheel" dir="down"/>
   <relatedto rel="2" asset="11" name="Rear Left Wheel" dir="down"/>
   <relatedto rel="2" asset="12" name="Rear Right Wheel" dir="down"/>
   <relatedto rel="2" asset="17" name="Engine" dir="down"/>
   <relatedto rel="2" asset="19" name="Drivers Seat" dir="down"/>
</response>
</code>

==Success (JSON)==

<code>
[{
	"relatedto": [{
		"rel": "2",
		"asset": "5",
		"name": "Showroom Floor",
		"dir": "up"
	}, {
		"rel": "2",
		"asset": "9",
		"name": "Front Left Wheel",
		"dir": "down"
	}, {
		"rel": "2",
		"asset": "10",
		"name": "Front Right Wheel",
		"dir": "down"
	}, {
		"rel": "2",
		"asset": "11",
		"name": "Rear Left Wheel",
		"dir": "down"
	}, {
		"rel": "2",
		"asset": "12",
		"name": "Rear Right Wheel",
		"dir": "down"
	}, {
		"rel": "2",
		"asset": "17",
		"name": "Engine",
		"dir": "down"
	}, {
		"rel": "2",
		"asset": "19",
		"name": "Drivers Seat",
		"dir": "down"
	}, {
		"rel": "2",
		"asset": "20",
		"name": "Front Passenger Seat",
		"dir": "down"
	}, {
		"rel": "2",
		"asset": "21",
		"name": "Rear Left Seat",
		"dir": "down"
	}, {
		"rel": "2",
		"asset": "22",
		"name": "Rear Right Seat",
		"dir": "down"
	}
}]
</code>

===Other Versions===

[[/api/asset/relate_get]] \\
[[/api/asset/relate_post]] \\
[[/api/asset/relate_delete]] \\