content_posts_detach_media

Tool

content_posts_detach_media

Remove media assets from a post, keeping the order of the rest.

Remove media assets from a post, keeping the order of the rest. Like any edit, it produces a new version and returns an approved post to pending_approval.

Behavior

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

Arguments

Name	Type	Required	Description
id	string	•	The post id.
mediaIds	array	•	Media asset ids to remove from 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

Remove media assets from a post, keeping the order of the rest.

When to use

Remove media assets from a post, keeping the order of the rest. Like any edit, it produces a new version and returns an approved post to pending_approval.

Example

Ask your agent something like this:

Remove media assets from a post, keeping the order of the rest.

The agent will invoke content_posts_detach_media with these arguments:

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