Tool reference

    Save CMS mapping

    Make an authorized change through your connected assistant.

    MCP TOOL outwrite_save_cms_connection

    outwrite_save_cms_connection

    Update a saved native CMS destination's label, author or field mappings using its existing credential and exact version. Cannot move credentials to a different endpoint. Changes affect campaigns using this account connection; review them with the user. Requires explicit user intent, confirm:true, a UUID idempotencyKey and maximumCredits for this immediate action. Recurring settings require recurringConsent:true after the user approves their ongoing costs. Retry identical arguments with the same key; inspect an uncertain receipt before any new action.

    Access and behavior

    PropertyValue
    Permissionaccount:manage
    EffectCan change your workspace

    Read the current workspace state before making a change. Respect the returned proposal, revision and operation state rather than assuming the request has finished.

    Parameters

    ParameterRequiredTypeDetails
    workspaceIdOptionalstringFormat: uuid.
    idRequiredstringFormat: uuid.
    versionRequiredintegerMaximum 9007199254740991.
    labelRequiredstringAt least 1 characters. Up to 120 characters.
    configRequiredvalueSee the complete schema below.
    idempotencyKeyRequiredstringFormat: uuid.
    confirmRequiredbooleanValue: true.
    maximumCreditsRequirednumberMinimum 0. Maximum 100000.
    recurringConsentOptionalbooleanDefault: false.

    Complete input schema

    The schema is generated from the registered tool contract. Account permissions, revision checks and cross-field validation also apply on the server.

    Code example
    {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "type": "object",
      "properties": {
        "workspaceId": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "id": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "version": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "label": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        },
        "config": {
          "oneOf": [
            {
              "type": "object",
              "properties": {
                "provider": {
                  "type": "string",
                  "const": "webflow_native"
                },
                "siteId": {
                  "type": "string",
                  "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                },
                "collectionId": {
                  "type": "string",
                  "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                },
                "publicOrigin": {
                  "type": "string",
                  "format": "uri"
                },
                "collectionSlug": {
                  "type": "string",
                  "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                },
                "mapping": {
                  "type": "object",
                  "properties": {
                    "title": {
                      "default": [],
                      "maxItems": 5,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                      }
                    },
                    "content": {
                      "type": "string",
                      "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                    },
                    "excerpt": {
                      "default": [],
                      "maxItems": 5,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                      }
                    },
                    "images": {
                      "default": [],
                      "maxItems": 5,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                      }
                    },
                    "defaults": {
                      "default": {},
                      "type": "object",
                      "propertyNames": {
                        "type": "string",
                        "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                      },
                      "additionalProperties": {
                        "anyOf": [
                          {
                            "type": "string",
                            "maxLength": 2000
                          },
                          {
                            "type": "number"
                          },
                          {
                            "type": "boolean"
                          },
                          {
                            "maxItems": 30,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "maxLength": 200
                            }
                          }
                        ]
                      }
                    }
                  },
                  "required": [
                    "content"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "provider",
                "siteId",
                "collectionId",
                "publicOrigin",
                "collectionSlug",
                "mapping"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "provider": {
                  "type": "string",
                  "const": "ghost"
                },
                "siteUrl": {
                  "type": "string",
                  "format": "uri"
                }
              },
              "required": [
                "provider",
                "siteUrl"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "provider": {
                  "type": "string",
                  "const": "wordpress_com"
                },
                "siteId": {
                  "type": "string",
                  "pattern": "^\\d+$"
                },
                "publicOrigin": {
                  "type": "string",
                  "format": "uri"
                }
              },
              "required": [
                "provider",
                "siteId",
                "publicOrigin"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "provider": {
                  "type": "string",
                  "const": "wix"
                },
                "siteId": {
                  "type": "string",
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                },
                "memberId": {
                  "type": "string",
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                },
                "publicOrigin": {
                  "type": "string",
                  "format": "uri"
                }
              },
              "required": [
                "provider",
                "siteId",
                "publicOrigin"
              ],
              "additionalProperties": false
            },
            {
              "type": "object",
              "properties": {
                "provider": {
                  "type": "string",
                  "const": "framer"
                },
                "projectId": {
                  "type": "string",
                  "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                },
                "collectionId": {
                  "type": "string",
                  "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                },
                "publicOrigin": {
                  "type": "string",
                  "format": "uri"
                },
                "collectionSlug": {
                  "type": "string",
                  "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                },
                "mapping": {
                  "type": "object",
                  "properties": {
                    "title": {
                      "default": [],
                      "maxItems": 5,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                      }
                    },
                    "content": {
                      "type": "string",
                      "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                    },
                    "excerpt": {
                      "default": [],
                      "maxItems": 5,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                      }
                    },
                    "images": {
                      "default": [],
                      "maxItems": 5,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                      }
                    },
                    "defaults": {
                      "default": {},
                      "type": "object",
                      "propertyNames": {
                        "type": "string",
                        "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                      },
                      "additionalProperties": {
                        "anyOf": [
                          {
                            "type": "string",
                            "maxLength": 2000
                          },
                          {
                            "type": "number"
                          },
                          {
                            "type": "boolean"
                          },
                          {
                            "maxItems": 30,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "maxLength": 200
                            }
                          }
                        ]
                      }
                    }
                  },
                  "required": [
                    "content"
                  ],
                  "additionalProperties": false
                },
                "allowProjectPublish": {
                  "default": false,
                  "type": "boolean"
                }
              },
              "required": [
                "provider",
                "projectId",
                "collectionId",
                "publicOrigin",
                "collectionSlug",
                "mapping"
              ],
              "additionalProperties": false
            }
          ]
        },
        "idempotencyKey": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "confirm": {
          "type": "boolean",
          "const": true
        },
        "maximumCredits": {
          "type": "number",
          "minimum": 0,
          "maximum": 100000
        },
        "recurringConsent": {
          "default": false,
          "type": "boolean"
        }
      },
      "required": [
        "id",
        "version",
        "label",
        "config",
        "idempotencyKey",
        "confirm",
        "maximumCredits"
      ],
      "additionalProperties": false
    }
    

    Working safely

    For an identical retry, reuse its idempotency key. If the saved state changed, read it again and prepare a new request. An operation that is queued or running is not complete.

    See permissions and safe actions and assistant workflows.

    Need a hand with your workspace?Get help