v2

latestOpenAPI 3.0.12026-07-263104131.9 MB
Asset Relationships

Get all asset relationships for an entity

Returns a paginated list of all asset relationships for a specific entity, optionally filtered by relationship type and relation side.

get/v2/itam/asset-relationship/{entityType}/{entityId}/relations

Path parameters

entityType'DEVICE' | 'CHECKLIST' | 'CONTACT' | 'CREDENTIAL' | 'APPS_SERVICES_DOCUMENT' | 'TECHNICIAN' | 'END_USER' | 'KB_ARTICLE' | 'LOCATION' | 'ORGANIZATION' required

The entity type of the asset

Example:DEVICE
entityIdinteger required

Unique identifier of the entity for which to retrieve relationships.

Query parameters

typestring

The relation type used to filter relationships. By default all relation types are returned.

side'SOURCE' | 'TARGET'

Whether to get ingoing or outgoing relationships. By default, both sides are returned.

afterstring

Cursor for forward pagination. Use nextCursor from previous response.

beforestring

Cursor for backward pagination. Use previousCursor from previous response.

pageSizeinteger

Number of results per page. Defaults to 100, minimum 1, maximum 500.

Response

A paginated list of asset relationships