thincms_list_posts
Filter and list blog posts by tag, status, category, author, date, or featured. Supports pagination and optional full content inclusion.
Instructions
List blog posts with optional filters. Returns posts without content by default (use includeContent=true for full HTML). Supports pagination.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Filter by tag name or slug | |
| page | No | Page number (default: 1) | |
| limit | No | Items per page (default: 20) | |
| series | No | Filter by series name | |
| siteId | No | Override the active site for this single call. Pass to target a specific tenant without mutating shared active-site state — the right pattern when running concurrent agent sessions managing different tenants. Must match a siteId from your THINCMS_SITES config (use thincms_list_sites to inspect). When omitted, the call uses the active site set by thincms_switch_site. | |
| status | No | Filter by status | |
| authorId | No | Filter by author ID | |
| category | No | Filter by category slug | |
| featured | No | Filter featured posts only | |
| publishedTo | No | ISO date: posts published before this date | |
| publishedFrom | No | ISO date: posts published after this date | |
| includeContent | No | Include full HTML content in results (default: false) | |
| confirmProductionWrite | No | Acknowledge that this call may write to a configured production site (THINCMS_PRODUCTION_SITE_IDS env var). Required for any POST/PUT/PATCH/DELETE against a production-listed site; ignored otherwise. The error message lists which site triggered the requirement and recommends thincms_snapshot before any production write. |