draft_post_from_thought

posts:writeuses credits

Turn a saved thought (see save_thought and list_thoughts) into ready-to-review posts for X and LinkedIn, written in the brand voice using the viral format that fits it best (hot take, lesson, story, list, how-to, before/after). visual 'image' adds an on-brand graphic and 'carousel' a swipeable carousel (a PDF on LinkedIn, the first 4 slides as images on X); aiBackground adds an AI-generated background, which is slower and costs money, so use it only when the user wants imagery. guidance steers the angle, e.g. 'contrarian hot take'.

Each call spends AI credits, so don't retry it in a loop. The posts land in the Review queue as pending approval and are never scheduled: show the user the copy and visual, edit with update_post, and publish only with approve_post_group once they confirm.

Input

• thoughtIdstring (uuid)required
• platformsarray<string>

  at least 1 items · at most 2 items · default ["x","linkedin"]

• visualstring

  one of none, image, carousel · default "none"

• guidancestring

  min length 1 · max length 500

• aiBackgroundboolean

  default false

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

Same action over the REST API

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