Edit content
content_writeCreates and updates entries, categories, comments, filters and video channels in a content module of the active site, sets entry tags and rates entries. Entries are published to the site.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Record, category, comment, or forum entity id. | |
| url | No | mchat author url field. | |
| www | No | Author website. | |
| mark | No | Guestbook rating: 1 good, 2 bad. | |
| name | No | Category, forum, section, or channel name; guestbook author name; author name or contact person of a publ, load, board, dir or stuff entry. | |
| tags | No | Comma-separated tags. | |
| No | Email (guestbook / author). | ||
| items | No | Filter values separated by |. | |
| ontop | No | 1 = pin entry/topic. | |
| title | No | Entry or topic title; FAQ subject. | |
| action | Yes | Operation to run. Each oneOf entry describes one action and lists its parameters. | |
| active | No | polls update: yes|no. | |
| answer | No | FAQ answer. | |
| author | No | Login (nick) of the entry author. | |
| closed | No | 1 = create closed topic. | |
| fields | No | Extra body keys not listed as top-level params. | |
| module | Yes | Content module code. poll is the same module as polls (module and settings lists name it poll). Not used by comments_all. The forum has its own forum_* tools. | |
| object | No | Video embed iframe HTML. | |
| other1 | No | Custom field 1 (see action=fields). | |
| other2 | No | Custom field 2. | |
| other3 | No | Custom field 3. | |
| other4 | No | Custom field 4. | |
| other5 | No | Custom field 5. | |
| ownurl | No | Custom URL slug or own URL. | |
| ad_type | No | Board ad type: value id of filter 3 (see filter_list), same as filter3. | |
| answer1 | No | polls add: first answer. | |
| answer2 | No | polls add: second answer. | |
| answers | No | Poll answers (| for forum, comma for site polls). | |
| custom1 | No | mchat custom field 1. | |
| custom2 | No | mchat custom field 2. | |
| filter1 | No | Value id of entry filter 1 (see filter_list); board takes several ids of filters 1-3 separated by commas. | |
| filter2 | No | Value id of entry filter 2. | |
| filter3 | No | Value id of entry filter 3 (board: the ad type). | |
| filter4 | No | Value id of entry filter 4. | |
| filter5 | No | Value id of entry filter 5. | |
| message | No | Full text (entry, comment, post); the format of an entry text is set by message_type. | |
| pending | No | 1 = moderation / pending-only list. | |
| poll_id | No | Poll id (forum or site polls). | |
| subject | No | FAQ subject line. | |
| user_id | No | Act-as user id. | |
| add_date | No | Publish date yyyy-mm-dd hh:mm. | |
| category | No | Category id (list filter / add). | |
| comments | No | 1 = allow comments, 0 = deny. | |
| password | No | Closed forum password. | |
| pollonly | No | 1 = poll-only mode. | |
| polltime | No | Poll duration, e.g. "1 week". | |
| position | No | Category position. | |
| question | No | FAQ question text. | |
| author_id | No | Author user id. | |
| file_path | No | Local MCP server path for file/photo/archive upload. Missing files are an error; remote agents must use file_base64, file_upload_id, or file_site_path. | |
| hgu_title | No | SEO slug in module path. | |
| link2site | No | Site link (dir). | |
| parent_id | No | Parent comment id. | |
| pollmulty | No | 1 = multi-select poll. | |
| subscribe | No | 1 = subscribe to comments. | |
| till_date | No | Board ad end date yyyy-mm-dd hh:mm; 31 days from now when not set. | |
| uplastmod | No | Update lastmod flag (maps to uplastmod/update_date/update_lastmod). | |
| access2add | No | Category add group ids (comma-separated). | |
| channel_id | No | Video channel id. | |
| cover_path | No | Local MCP server path for cover upload. Missing files are an error; remote agents must use cover_base64, cover_upload_id, or cover_site_path. | |
| filter_num | No | Filter number 1-3. | |
| image_path | No | Local MCP server path for image (entry file1 or category file). Missing files are an error; remote agents must use image_base64, image_upload_id, or image_site_path. | |
| meta_title | No | Meta title for an entry or a module category. | |
| photo_path | No | Local MCP server path for photo upload (multipart). Missing files are an error; remote agents must use photo_base64, photo_upload_id, or photo_site_path. | |
| access2page | No | Category page access group ids. | |
| author_site | No | Author website (publ, load, board, dir, stuff). | |
| description | No | Short description / FAQ question; its format is set by description_type. | |
| file_base64 | No | Base64 file body with file_filename (remote upload). Wins over file_upload_id, file_site_path, and file_path. | |
| link2source | No | Source link (publ). | |
| show_attach | No | news, blog: 1 = show the Attachments block (links to the entry images) on the entry page, 0 = hide it. Off for a new entry unless set; an update without it keeps the current value. | |
| archive_path | No | Local MCP server path for load archive. Missing files are an error; remote agents must use archive_base64, archive_upload_id, or archive_site_path. | |
| author_email | No | Author or contact email (publ, load, board, dir, stuff). | |
| author_phone | No | Contact phone (board). | |
| cover_base64 | No | Base64 cover body with cover_filename (remote upload). Wins over cover_upload_id, cover_site_path, and cover_path. | |
| image_base64 | No | Base64 image body with image_filename (remote upload). Wins over image_upload_id, image_site_path, and image_path. | |
| message_type | No | Format of message (faq: answer) on add and update: plain escapes the markup, bb turns BB codes into HTML, html keeps the HTML. news and load always keep the HTML; blog, publ, board, dir, stuff and faq keep it only when the user group may use HTML in the module, otherwise the markup is escaped. Without it a non-empty text of these modules is saved as html. | |
| photo_base64 | No | Base64 photo body with photo_filename (remote upload). Wins over photo_upload_id, photo_site_path, and photo_path. | |
| file_filename | No | File name for file_base64, with extension. | |
| meta_keywords | No | Meta keywords for an entry or a module category. | |
| archive_base64 | No | Base64 archive body with archive_filename (remote upload). Wins over archive_upload_id, archive_site_path, and archive_path. | |
| cover_filename | No | File name for cover_base64, with extension. | |
| file_site_path | No | File already on the site (img/x.jpg or its full site URL). Wins over file_path. | |
| file_upload_id | No | upload_id from upload_direct. Wins over file_site_path and file_path. | |
| image_filename | No | File name for image_base64, with extension. | |
| photo_filename | No | File name for photo_base64, with extension. | |
| access2category | No | Category view group ids (comma-separated). | |
| cover_site_path | No | File already on the site (img/x.jpg or its full site URL). Wins over cover_path. | |
| cover_upload_id | No | upload_id from upload_direct. Wins over cover_site_path and cover_path. | |
| image_site_path | No | File already on the site (img/x.jpg or its full site URL). Wins over image_path. | |
| image_upload_id | No | upload_id from upload_direct for the first material image (multipart file1). Wins over image_site_path and image_path. | |
| photo_site_path | No | File already on the site (img/x.jpg or its full site URL). Wins over photo_path. | |
| photo_upload_id | No | upload_id from upload_direct. Wins over photo_site_path and photo_path. | |
| screenshot_path | No | Local MCP server path for load/video screenshot. Missing files are an error; remote agents must use screenshot_base64, screenshot_upload_id, or screenshot_site_path. | |
| archive_filename | No | File name for archive_base64, with extension. | |
| description_type | No | Format of description (faq: question); the same as message_type. | |
| image_upload_ids | No | Comma-separated upload_id values from upload_direct. They fill material image slots file1, file2, and so on, after image_upload_id when that is also set. At most 50. | |
| meta_description | No | Meta description for an entry or a module category. | |
| archive_site_path | No | File already on the site (img/x.jpg or its full site URL). Wins over archive_path. | |
| archive_upload_id | No | upload_id from upload_direct. Wins over archive_site_path and archive_path. | |
| screenshot_base64 | No | Base64 screenshot body with screenshot_filename (remote upload). Wins over screenshot_upload_id, screenshot_site_path, and screenshot_path. | |
| screenshot_filename | No | File name for screenshot_base64, with extension. | |
| screenshot_site_path | No | File already on the site (img/x.jpg or its full site URL). Wins over screenshot_path. | |
| screenshot_upload_id | No | upload_id from upload_direct. Wins over screenshot_site_path and screenshot_path. |