Post

1 action. Each is callable by the agent as a tool, over HTTP via /api/invoke, and (usually) from a UI page.

post

POST · mutating

One-shot publish: create a content-draft ticket and immediately post it (or schedule it). Routes through posts.publish which automatically picks Stagehand session, Composio API, or manual queue based on the platform + persona. Use when the user says "post X to Y" and there's no need for a review step. Skips human approval — only call when the mission's autonomy allows.

When the agent calls it: Only call this when (a) the user told you to publish immediately and (b) the mission autonomy permits skipping review. For supervised missions, use content.drafts.generate (creates a draft for human approval) instead. When personaSubjectId is omitted, the picker chooses one from the mission's personas. The chosen persona's session/connection routes the publish.

• AI tool: post
• API: POST /api/invoke/post

Input

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "platform": {
      "type": "string"
    },
    "content": {
      "type": "string"
    },
    "missionId": {
      "type": "string",
      "minLength": 1
    },
    "subjectId": {
      "type": "string",
      "minLength": 1
    },
    "personaSubjectId": {
      "type": "string",
      "minLength": 1
    },
    "scheduleFor": {},
    "hashtags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "platform",
    "content"
  ]
}