thincms_create_collection_item
Add an item to a collection with required body (HTML) and optional fields like title, rating, link, image, and sort order. Supports site targeting and production write confirmation.
Instructions
Add an item to a collection. The 'body' field is required (main content, can be HTML). Other fields are optional and visibility depends on the collection's show* settings.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | Main content text or HTML (required) | |
| title | No | Item title (e.g., person name, product name) | |
| rating | No | Rating 1-5 (for reviews/testimonials) | |
| 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. | |
| enabled | No | Whether item is visible (default: true) | |
| linkUrl | No | Link URL (product page, profile, etc.) | |
| imageUrl | No | Image URL (photo, product image, logo) | |
| linkText | No | Link button text (default: 'Learn more') | |
| subtitle | No | Subtitle (e.g., role, company, price) | |
| sortOrder | No | Sort order (auto-assigned to end if omitted) | |
| collectionId | Yes | Collection ID | |
| 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. |