content_posts_attach_media

Tool

content_posts_attach_media

Attach stored media assets to a post, appended in the given order.

Attach stored media assets to a post, appended in the given order. Only assets that are ready can be attached. This counts as an edit: the post gets a new version and an approved post returns to pending_approval.

Behavior

HTTP: POST /content/posts/:id/media/attach

Arguments

Name	Type	Required	Description
id	string	•	The post id.
mediaIds	array	•	Media asset ids, in the order they should appear on the post.

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

Attach stored media assets to a post, appended in the given order.

When to use

Example

Ask your agent something like this:

Attach stored media assets to a post, appended in the given order.

The agent will invoke content_posts_attach_media with these arguments:

{
  "id": "<id>",
  "mediaIds": "<mediaIds>"
}