XISUITEDokumentation

asset-object-comments

4 Endpunkte. Basis-URL: https://xapi.ambertech.cloud/api/v1

List comments for an asset object#

GET/spaces/{spaceId}/assets/objects/{id}/commentsToken

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring

Space UUID

idPflichtPfadstring

Object UUID

Antworten

  • 200Comment list returned (ordered oldest-first, includes author user details)
  • 401Not authenticated
  • 403Missing view_assets permission or module disabled
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/assets/objects/{id}/comments" \
  -H "Authorization: Bearer $XISUITE_TOKEN"

Post a comment on an asset object#

POST/spaces/{spaceId}/assets/objects/{id}/commentsToken

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring

Space UUID

idPflichtPfadstring

Object UUID

Request-Bodyapplication/jsonCreateAssetObjectCommentDto

NameTypBeschreibung
contentPflichtstring

Comment text

Antworten

  • 201Comment created
  • 400Validation error (content 1–5000 chars required)
  • 401Not authenticated
  • 403Missing view_assets permission or module disabled
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/assets/objects/{id}/comments" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"…"}'

Edit a comment (author only)#

PATCH/spaces/{spaceId}/assets/objects/{id}/comments/{commentId}Token

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring

Space UUID

idPflichtPfadstring

Object UUID

commentIdPflichtPfadstring

Comment UUID

Request-Bodyapplication/jsonUpdateAssetObjectCommentDto

NameTypBeschreibung
contentPflichtstring

Replacement comment text

Antworten

  • 200Comment updated
  • 400Validation error
  • 401Not authenticated
  • 403Not the comment author or module disabled
  • 404Comment not found
Beispiel (cURL)
curl -X PATCH "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/assets/objects/{id}/comments/{commentId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"…"}'

Delete a comment (author only)#

DELETE/spaces/{spaceId}/assets/objects/{id}/comments/{commentId}Token

Parameter

NameOrtTypBeschreibung
spaceIdPflichtPfadstring

Space UUID

idPflichtPfadstring

Object UUID

commentIdPflichtPfadstring

Comment UUID

Antworten

  • 200Comment deleted
  • 401Not authenticated
  • 403Not the comment author or module disabled
  • 404Comment not found
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/spaces/{spaceId}/assets/objects/{id}/comments/{commentId}" \
  -H "Authorization: Bearer $XISUITE_TOKEN"
Stand: 25. Oktober 2026© 2026 XISUITE · AmberTech Solutions