upsertCMSItem — Unframer

upsertCMSItemTOOL

Creates a new CMS item or updates an existing one.

IMPORTANT: Call getCMSCollections first to get field IDs and see the field data format documentation.

For creating a new item:

Provide slug and fieldData (itemId should be omitted)
The slug must be unique within the collection

For updating an existing item:

Provide itemId and any fields to update
Only included fields will be changed (partial updates supported)

The field structure must match the collection's field definitions from getCMSCollections.

idempotent

Parameters

collectionId *string

The ID of the CMS collection

itemId?string

ID of existing item to update (omit to create new)

slug?string

URL-friendly identifier (required for new items, optional for updates)

fieldData?object

Field values as an object where each key is a field ID and each value is a entry

draft?boolean

Draft status (default: false for new items)

Ask AI about this page

Request example

{
  "method": "tools/call",
  "params": {
    "name": "upsertCMSItem",
    "arguments": {
      "collectionId": "string",
      "itemId": "string",
      "slug": "string",
      "fieldData": {},
      "draft": true
    }
  }
}