Skip to content

Updates actions

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

events.updates · read

Call at the start of a conversation. Returns what happened since this connection last checked: posts that went live or failed, posts doing better than usual, new leads, DMs, Worker drafts waiting, mentions and replies. Lead with what needs the user.

  • MCP tool: get_updates. Loaded by default in MCP clients.
  • REST: GET /v1/events/updates
  • CLI: xholic events updates
  • Scope: read
  • Plan: Every plan, including the trial
  • Cost: Free.
  • Rate limit bucket: read

Input

Field Type Required Description
since string ≤ 40 chars No Cursor from a previous call. Leave it out to continue from the last check.
limit integer 1–100 No
account string ≤ 64 chars No X account to act on, as @handle. Leave it out to use the connection’s default account.