content_posts_update

Tool

content_posts_update

Edit a post.

Edit a post. The edit is recorded as a new immutable version; an edit to an approved post returns it to pending_approval, because an approval binds to one specific text.

Behavior

HTTP: PATCH /content/posts/:id

Arguments

Name	Type	Required	Description
id	string	•	The post id returned by content_posts_create.
text	string	—	Replacement text, in markdown. Omit to keep the current text.
media	array	—	Replacement media list (replaces, never merges). Omit to keep the current media.

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

Edit a post.

When to use

Edit a post. The edit is recorded as a new immutable version; an edit to an approved post returns it to pending_approval, because an approval binds to one specific text.

Example

Ask your agent something like this:

Edit a post.

The agent will invoke content_posts_update with these arguments:

{
  "id": "<id>"
}