draft_reply

posts:writeuses credits

Write a fresh reply to one reply-inbox item in the user's brand voice, e.g. when they didn't like the draft. guidance steers it, e.g. 'ask them a question' or 'shorter and warmer'.

When the model thinks the post is best left alone, draftText stays empty and draftReason says why. Spends AI credits and posts nothing; you can also write the reply yourself with update_reply_draft.

Input

• itemIdstring (uuid)required
• guidancestring

  min length 1 · max length 300

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": "draft_reply",
    "arguments": {
      "itemId": "3f8e2c1a-0000-4000-8000-000000000000"
    }
  }
}

Same action over the REST API

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