Skip to content
AdVentur.aiAdVentur.aiAdVentur.ai Docs

save_thought

posts:write

Save a thought, tip, opinion, story or lesson the user wants to post about, e.g. a note from their notes app. Pass their words as text with light cleanup only, keeping their voice and specifics; save separate ideas as separate thoughts.

AdVentur.ai takes saved thoughts into account whenever it writes posts for the workspace. It spends no credits and posts nothing. To turn one into drafts now, call draft_post_from_thought with the returned id.

Input

  • textstringrequired

    min length 3 · max length 4000

  • kindstring

    one of thought, tip, opinion, story, lesson · default "thought"

  • sourcestring

    min length 1 · max length 60

  • tagsarray<string>

    at most 8 items

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

Same action over the REST API

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