# SetHandleWatched

> Turn capture on or off for one partner handle; body is { watched }. Write access, partners toolset, MCP tool set_handle_watched.

> **Warning:**
> This operation removes or replaces something. MCP clients see it with `destructiveHint` set, and an agent should tell you what it will change and wait for your yes.

**Access:** [Write](https://developer.missin.co.uk/get-started/authentication.md#access-levels)

## Variables

| Variable | Type | Required | Accepts | Description |
|---|---|---|---|---|
| `body` | `JSON!` | yes | Object, fields below |  |
| `rowId` | `UUID!` | yes |  |  |

## Input types

### `body`

| Field | Type | Required | Accepts | Description |
|---|---|---|---|---|
| `handle` | string | no | 1 to 80 characters |  |
| `url` | string (uri) or null | no | format uri |  |
| `watched` | boolean | no |  |  |
| `platform_user_id` | string or null | no | 1 to 120 characters |  |

## Call it

```bash curl
curl https://api.missin.co.uk/graphql/v1 \
  -H "Authorization: Bearer $MISSIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operationName":"SetHandleWatched","variables":{"body":{"watched":true},"rowId":"00000000-0000-0000-0000-000000000000"},"extensions":{"persistedQuery":{"version":1,"sha256Hash":"aa63cfd9e17f9760fb2fec2c99245f5580e6ab2e4608cf9ab0253e5caf71f989"}}}'
```

## Document

```graphql
mutation SetHandleWatched($body: JSON!, $rowId: UUID!) { __typename updatePartnerSocialNetwork(input: {accountId: $rowId, body: $body}) { __typename partnerSocialNetwork { __typename id rowId watched } userErrors { __typename code field message } } }
```

Source: https://developer.missin.co.uk/reference/partners/set-handle-watched