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

# Watch

> MCP tools for managing pins and subscriptions on entities.

## get\_watches\_by\_owner

Get all watches (pins and subscriptions) for an entity.

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

### Parameters

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

### Returns

A list of `WatchDto` objects, each containing:

* `watchId` — unique watch identifier
* `ownerId` — the entity being watched
* `watcherId` — the watcher (user, email, or user group)
* `type` — watch type (`Pin` or `Follower`)
* `watcherType` — watcher entity type

***

## get\_watches\_by\_watcher

Get all watches created by a specific watcher.

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

### Parameters

| Parameter   | Type   | Required | Description                                  |
| ----------- | ------ | -------- | -------------------------------------------- |
| `watcherId` | string | Yes      | The watcher ID (user, email, or user group). |

### Returns

A list of `WatchDto` objects.

***

## get\_watch

Get a single watch by its ID.

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

### Parameters

| Parameter | Type   | Required | Description   |
| --------- | ------ | -------- | ------------- |
| `watchId` | string | Yes      | The watch ID. |

### Returns

A `WatchDto` with watch details.

***

## create\_watch

Create a new watch (pin or subscription) on an entity.

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

### Parameters

| Parameter   | Type   | Required | Description                                                                  |
| ----------- | ------ | -------- | ---------------------------------------------------------------------------- |
| `ownerId`   | string | Yes      | The entity to watch (e.g. item ID).                                          |
| `watcherId` | string | Yes      | The watcher (user ID). Use [`get_user_list`](/mcp-tools/user#get_user_list). |
| `type`      | string | No       | Watch type: `Pin` (default) or `Follower`.                                   |

### Returns

The created `WatchDto`.

***

## update\_watch

Update a watch's type.

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

### Parameters

| Parameter | Type   | Required | Description                                                                                                               |
| --------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| `watchId` | string | Yes      | The watch ID. Use [`get_watches_by_owner`](#get_watches_by_owner) or [`get_watches_by_watcher`](#get_watches_by_watcher). |
| `type`    | string | No       | New watch type: `Pin` or `Follower`.                                                                                      |

### Returns

The updated `WatchDto`.

***

## delete\_watch

Delete a watch by its ID.

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

### Parameters

| Parameter | Type   | Required | Description                                                                                                               |
| --------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| `watchId` | string | Yes      | The watch ID. Use [`get_watches_by_owner`](#get_watches_by_owner) or [`get_watches_by_watcher`](#get_watches_by_watcher). |

### Returns

A confirmation message.