Skip to content

Suggestions actions

2 actions. Every field marked Required must be sent; account, dryRun, idempotencyKey, confirmCredits and quoteId are the control fields every surface adds.

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.

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.