# Suggestions actions

> Suggestions: 2 Xholic actions (0 read, 2 change), each with its MCP tool, REST endpoint and CLI command.

Source: https://docs.xholic.ai/actions/suggestions/

2 actions. Every field marked *Required* must be sent; `account`, `dryRun`, `idempotencyKey`, `confirmCredits` and `quoteId` are the [control fields](/api/responses/#control-fields) every surface adds.

## Keep as is

`suggestions.keep` · write

The owner is happy with something Xholic suggested changing (for example their bio in the profile check): stop suggesting it and leave it out of the score until that part changes. Only when the user says so. Call it only when the user asked for this in the conversation; never on your own initiative.

- **MCP tool:** `dismiss_suggestion`. Loaded by default in MCP clients.
- **REST:** `POST /v1/suggestions/keep`
- **CLI:** `xholic suggestions keep`
- **Scope:** `write`
- **Plan:** Every plan, including the trial
- **Cost:** Free.
- **Rate limit bucket:** `write`

**Input**

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `kind` | "profile_check" | No | Default: `"profile_check"`. |
| `id` | string ≤ 40 chars | Yes | The suggestion's id, e.g. a profile check id such as "bio". |
| `account` | string ≤ 64 chars | No | X account to act on, as @handle. Leave it out to use the connection's default account. |
| `note` | string ≤ 20000 chars | No | Optional, on any tool: one or two sentences for Xholic's shared memory about what the user just decided, asked for or said about themselves or their plans (e.g. "Dropping threads for now; focusing on replies to founders"). Every AI the user connects reads it, so they never repeat themselves. In your words, never other people's posts. Leave it out when nothing new was said. |
| `dryRun` | boolean | No | Return exactly what would happen without doing it. |
| `idempotencyKey` | string ≤ 200 chars | No | A unique key for this write. Repeating a call with the same key returns the first result instead of acting twice. |

## Suggest it again

`suggestions.restore` · write

Undo Keep as is: Xholic suggests that change again and counts it in the score. Call it only when the user asked for this in the conversation; never on your own initiative.

- **MCP tool:** `restore_suggestion`. Catalog: reach it with `find_actions` and `run_write_action`, or turn on the full toolset.
- **REST:** `POST /v1/suggestions/restore`
- **CLI:** `xholic suggestions restore`
- **Scope:** `write`
- **Plan:** Every plan, including the trial
- **Cost:** Free.
- **Rate limit bucket:** `write`

**Input**

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `kind` | "profile_check" | No | Default: `"profile_check"`. |
| `id` | string ≤ 40 chars | Yes | The suggestion's id, e.g. a profile check id such as "bio". |
| `account` | string ≤ 64 chars | No | X account to act on, as @handle. Leave it out to use the connection's default account. |
| `note` | string ≤ 20000 chars | No | Optional, on any tool: one or two sentences for Xholic's shared memory about what the user just decided, asked for or said about themselves or their plans (e.g. "Dropping threads for now; focusing on replies to founders"). Every AI the user connects reads it, so they never repeat themselves. In your words, never other people's posts. Leave it out when nothing new was said. |
| `dryRun` | boolean | No | Return exactly what would happen without doing it. |
| `idempotencyKey` | string ≤ 200 chars | No | A unique key for this write. Repeating a call with the same key returns the first result instead of acting twice. |
