Tool
content_posts_create
Create a post.
Create a post. It starts as a draft at version 1; submit it for approval when the text is ready.
Behavior
- HTTP
POST /content/posts
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
| text | string | • | The post text, channel-independent, written in markdown — bold, italic, lists, links. Each network gets it flattened to the plain text that network accepts; content_publications_validate shows exactly what that looks like per channel. Per-channel variants come later, at publish time. |
| media | array | — | Media references attached to the post, in display order. Opaque strings — the toolkit does not upload or resolve them. |
Response
| Field | Type | Always | Description |
|---|---|---|---|
| id | string | • | Post id. |
| text | string | • | The current text of the post, in markdown. |
| media | array | • | Media references attached to the current version. |
| author | string | • | Identity id of whoever composed the post. |
| status | string | • | Post lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline. |
| createdAt | string | • | ISO-8601 creation time. |
| updatedAt | string | • | ISO-8601 time of the last change. |
| currentVersion | integer | • | Version number of the current text. |
| approvedVersion | integer | • | The version an approval binds to, or null. Cleared on every edit: approving one text never covers another. |
Try it
Create a post.