rewrite_post

posts:writeuses credits

Generate 3 to 5 better versions of a piece of post copy in the workspace's brand voice and the author's own writing voice, for a platform and optional tone. Pass instruction to say what to change (e.g. shorter, punchier hook, more casual); without one, each version takes a different direction.

Each call spends the workspace's AI credits, so call it only when the user wants AI rewrites, not to polish copy you can edit yourself, and don't retry it in a loop. It saves nothing: show the user the variations, and apply the one they choose with update_post. Confirm the copy with the user before calling approve_post_group.

Input

• textstringrequired

  min length 1 · max length 25000

• tonestring

  max length 120

• platformstring

  one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads · default "x"

• variantCountinteger

  min 3 · max 5 · default 4

• instructionstring

  max length 300

• maxLengthinteger

  max 25000

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": "rewrite_post",
    "arguments": {
      "text": "string"
    }
  }
}

Same action over the REST API

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