content_posts_list

Tool

content_posts_list

List posts, including ideas, each with its outputs and their states.

List posts, including ideas, each with its outputs and their states. Filter by status (partially_published for posts with some outputs out and others not) or folderId (null for unfiled posts). With a folder filter, posts appear in plan order; otherwise newest first.

Behavior

HTTP: GET /content/posts

Arguments

Name	Type	Required	Description
limit	integer	—	Maximum number of posts to return (1-100, default 50).
offset	integer	—	How many posts to skip, for paging.
status	string	—	Return only posts in this status.
folderId	string	—	Filter to one folder, or null for posts in no folder. Omit for posts in every folder.

Response

Field	Type	Always	Description
posts	array	•	The page of posts, ordered by position when filtered to a folder and newest first otherwise.
total	integer	•	Total number of matching posts, ignoring paging.

Try it

List posts, including ideas, each with its outputs and their states.

When to use

Example

Ask your agent something like this:

List posts, including ideas, each with its outputs and their states.

The agent will invoke content_posts_list with these arguments:

{}