Skip to content
AdVentur.aiAdVentur.aiAdVentur.ai Docs

refresh_reply_inbox

posts:writeuses credits

Check X for new replies to and mentions of the user's account, new posts from the accounts and keywords they watch and from their Engage feeds (see update_engagement_settings), and, when Reddit listening is set up, new Reddit threads where people describe the problem their product solves. Then draft a reply to each in their brand voice (Reddit threads not worth a reply are skipped). Pass feedId to check just one Engage feed, e.g. to catch new posts early.

Returns the new items plus warnings in plain words when part of it failed. Each call reads from X and spends AI credits, so call it once per conversation, not in a loop. It never posts anything: show the user the drafts, and send a reply only with send_reply after they approve its exact text.

Input

  • feedIdstring

    min length 1 · max length 64

Permission

Needs the posts:write scope: create drafts. It changes your workspace, so clients may ask you to confirm each call.

Example call

Your assistant sends this for you. It is shown so you can see the shape of a call, with placeholder values for the required fields.

tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "refresh_reply_inbox",
    "arguments": {}
  }
}

Same action over the REST API

The tool runs POST /v1/orgs/{orgId}/engagement/refresh as the signed-in user, with the same validation, approval rules and limits. See it in the Reply inbox API reference.