Update a post's settings
update_post_settingsOn one site of the account, named in site. The drawer's fields, any subset: title, slug (blank regenerates from the title), subtitle (the line under the title, inline Markdown: italic, bold, a link; blank removes it), tags (the whole list, names), authors (the whole list in byline order, staff slugs or names; editors and above), featured, comments (whether members may comment; a post starts open, a page closed), visibility, tiers and circles (who reads past the excerpt), meta title and description, the cover's alt and caption, header layout, a page's place in a collection (collection for its top level, parent_id to go under a page, collection "" to leave), and a collection page's fields. Content is edit_post's; status is publish_post's. Many posts at once is change_posts'.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"site": "<site>",
"post_id": "<post_id>"
},
"name": "update_post_settings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site | Yes | The site to work on, as list_sites names it | |
| slug | No | ||
| tags | No | ||
| tiers | No | Tier names, for visibility specific: the whole list | |
| title | No | ||
| fields | No | A page's field values by name, for the fields its collection's level names (get_collection gives them): {"location": {"lat": -33.89, "lng": 151.27}, "break": "Reef"}. A field left out keeps its value; null clears it | |
| authors | No | The whole list, first leading the byline: staff slugs or names | |
| circles | No | Circle names or slugs, for visibility specific, where the publication has circles: the whole list | |
| post_id | Yes | ||
| comments | No | ||
| featured | No | ||
| subtitle | No | ||
| parent_id | No | The page it goes under, in that page's collection (get_collection gives the ids) | |
| collection | No | A collection's id, slug or name: the page goes on its top level. "" takes it out of every collection | |
| meta_title | No | ||
| visibility | No | Who reads past the excerpt: public (everyone), members (any signed-in member), paid (a paying or comped member), specific (a member on any tier named in tiers or in any circle named in circles; name at least one) | |
| header_layout | No | ||
| meta_description | No | ||
| feature_image_alt | No | ||
| feature_image_caption | No |