Skip to content

send_reply

posts:publish

Post a reply from the user's account: to a mention on X, or as a comment on a Reddit thread (platform 'reddit'). Only call this after showing the user the post and the exact reply text and they have said to send it; pass that exact text. It posts publicly and can't be undone from here.

It works only for items with canSendFromApp: X only lets apps reply to people who mentioned the account, and Reddit needs a connected Reddit account. Otherwise give the user replyOnXUrl (the X reply box, or the Reddit thread) to post it themselves. Sends one reply per call; never loop over the inbox.

Input

  • itemIdstring (uuid)required
  • textstringrequired

    min length 1 · max length 1000

Permission

Needs the posts:publish scope: publish posts now. 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": "send_reply",
"arguments": {
"itemId": "3f8e2c1a-0000-4000-8000-000000000000",
"text": "string"
}
}
}

Same action over the REST API

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