API reference · Assets
GET/api/v1/assets/{id}/relationships

List asset relationships

Returns asset_relationships rows for the path asset ID in the authenticated tenant, joined with the related assets table for display fields. The service filters by asset_relationships.asset_id and context.tenant and joins related assets on matching tenant. It performs no parent asset existence check and does not filter soft-deleted related assets. Response links currently point at /api/v2/assets paths. In the current v1 asset route wiring, req.context may be absent because no route-level API-key auth wrapper sets it, causing a 500 before lookup.

RBAC · asset

Path parameters

idstring <uuid>Required
Asset UUID from assets.asset_id.

Response body

Success response 200 · schema AssetRelationshipListResponse

successbooleanRequired
Enum: true
dataobjectRequired
dataarray of AssetRelationshipRowRequired
Relationship rows for the asset. Empty when no relationships exist or the asset is not found.
itemsobject
relationship_idstring <uuid>Required
Primary key from asset_relationships.relationship_id.
asset_idstring <uuid>Required
Source asset UUID from asset_relationships.asset_id.
related_asset_idstring <uuid>Required
Related asset UUID from asset_relationships.related_asset_id.
relationship_typestringRequired
Free-form relationship type.
tenantstring <uuid>Required
Tenant UUID from asset_relationships.tenant.
created_atstring <date-time>
Relationship creation timestamp.
asset_tagstring
Related asset tag from joined related_assets, present in list responses.
related_asset_namestring
Related asset name from joined related_assets, present in list responses.
asset_typestring
Related asset type from joined related_assets, present in list responses.
Enum: workstationnetwork_deviceservermobile_deviceprinterunknown
statusstring
Related asset status from joined related_assets, present in list responses.
_linksobjectRequired
Relationship links. The controller currently points these at /api/v2/assets paths.
selfobject
hrefstringRequired
Target URL for the related operation.
methodstring
HTTP method for the link when supplied.
createobject
hrefstringRequired
Target URL for the related operation.
methodstring
HTTP method for the link when supplied.
parentobject
hrefstringRequired
Target URL for the related operation.
methodstring
HTTP method for the link when supplied.
metaobjectRequired
timestampstring <date-time>Required
Response timestamp generated by createApiResponse/createErrorResponse.
versionstringRequired
API response version string.

Response codes

200
Asset relationships returned successfully.
401
x-api-key is missing at middleware.
403
Authenticated request context lacks permission to read asset relationships when auth wiring is present.
500
Unexpected error, including missing req.context in the current route wiring.