> ## Documentation Index
> Fetch the complete documentation index at: https://ekso.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Annotation

> MCP tools for managing comments and annotations on entities.

<Note>
  For email-originated tickets, use the [Ticketing](/mcp-tools/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.
</Note>

## get\_annotations\_by\_owner

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

| Property      |     |
| ------------- | --- |
| **Read-only** | Yes |

### Parameters

| Parameter | Type   | Required | Description                                             |
| --------- | ------ | -------- | ------------------------------------------------------- |
| `ownerId` | string | Yes      | The entity ID to get annotations for (e.g. an item ID). |

### 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.

| Property      |     |
| ------------- | --- |
| **Read-only** | Yes |

### Parameters

| Parameter      | Type   | Required | Description        |
| -------------- | ------ | -------- | ------------------ |
| `annotationId` | string | Yes      | The annotation ID. |

### Returns

An `AnnotationDto` with annotation details.

***

## create\_annotation

Create a new annotation (comment) on an entity.

| Property      |    |
| ------------- | -- |
| **Read-only** | No |

### Parameters

| Parameter     | Type   | Required | Description                                                                           |
| ------------- | ------ | -------- | ------------------------------------------------------------------------------------- |
| `ownerId`     | string | Yes      | The entity being annotated (e.g. item ID).                                            |
| `annotatorId` | string | Yes      | The user making the annotation. Use [`get_user_list`](/mcp-tools/user#get_user_list). |
| `content`     | string | Yes      | The annotation body text.                                                             |
| `contentType` | string | No       | Content type. Defaults to the first supported type (Text).                            |

### Returns

The created `AnnotationDto`.

***

## update\_annotation

Update an annotation's content.

| Property      |    |
| ------------- | -- |
| **Read-only** | No |

### Parameters

| Parameter      | Type   | Required | Description                                                                     |
| -------------- | ------ | -------- | ------------------------------------------------------------------------------- |
| `annotationId` | string | Yes      | The annotation ID. Use [`get_annotations_by_owner`](#get_annotations_by_owner). |
| `content`      | string | No       | New annotation body text.                                                       |

### Returns

A confirmation message.