asset-object-references

Get inbound and outbound references for an asset object#

Returns two arrays: outbound (this object points to others) and inbound (others point to this object). Each reference includes joined relation_type, source, and target object details.

Parameter

Antworten

• 200Grouped inbound and outbound references returned
• 401Not authenticated
• 403Missing view_assets permission or module disabled
• 404Object not found

curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/assets/objects/{id}/references" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Create a directed reference from this object to another#

Both objects must be in the same space. Self-references and duplicate references are rejected.

Parameter

Request-Bodyapplication/jsonCreateAssetObjectReferenceDto

Antworten

• 201Reference created
• 400Self-reference, cross-space reference, or validation error
• 401Not authenticated
• 403Missing edit_assets permission or module disabled
• 404Source or target object not found
• 409Reference already exists between these objects

curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/assets/objects/{id}/references" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target_object_id":"…"}'

Delete a reference between two objects#

Parameter

Antworten

• 200Reference deleted
• 401Not authenticated
• 403Missing edit_assets permission or module disabled
• 404Reference not found

curl -X DELETE "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/assets/objects/{id}/references/{referenceId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"