Skip to main content
For email-originated tickets, use the Ticketing tools instead. get_ticket_conversation returns the email thread (inbound/outbound messages), while get_annotations_by_owner returns internal team comments. Use reply_to_ticket to send an email reply, and create_annotation for internal-only notes.

​
get_annotations_by_owner

Get all annotations (comments) for an entity by its owner ID.

​
Parameters

​
Returns

A list of AnnotationDto objects ordered by creation date ascending, each containing:
  • annotationId — unique annotation identifier
  • ownerId — the entity being annotated
  • annotatorId — the user who created the annotation
  • contentType — annotation content type (e.g. Text)
  • content — the annotation body
  • created — creation timestamp

​
get_annotation

Get a single annotation by its ID.

​
Parameters

​
Returns

An AnnotationDto with annotation details.

​
create_annotation

Create a new annotation (comment) on an entity.

​
Parameters

​
Returns

The created AnnotationDto.

​
update_annotation

Update an annotation’s content.

​
Parameters

​
Returns

A confirmation message.