Servers Playground How we check Add a server Log in

Carryo Website Publisher

Working · 4.0 s

io.carryo/website-publisherv0.1.0 Domain verified

Publish and update HTML websites, landing pages, reports and proposals from AI chat. OAuth sign-in.

Marketing & SEO

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.carryo.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

account.check_publishing Read-only

Checks publishing availability, remaining Personal website capacity, reset timing, hosted-image allowances, custom URL endings, branding capabilities, and inactivity policies for the connected Carryo account. Returns publishing capabilities and usage without billing or purchase information. Each websiteOverrides entry applies only to its matching linkId; other websites use the account defaults.

This tool takes no arguments.

Carryo Website Publisher MCP server | mcptry

Tools (13)

account.check_publishing

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

team.list

Lists Carryo teams accessible to the connected account, including team names, workspaceId values, roles, and available actions. Supports finding a team the user has chosen. Team creation, invitations, membership, and billing are managed in the Carryo web app.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

website.edit

Replaces the complete HTML of an existing Carryo website while preserving its linkId and URL. Suitable for updating, fixing, or republishing a known page. Returns the website link and a Carryo management link. Access and edit limits are checked for the website identified by linkId. expectedVersionNumber detects conflicting edits. Supports adding or replacing hosted images and removing paths through removeAssetPaths. Pass attached images through imageFiles. For one attachment, assets needs only its relative website path; Carryo matches the attachment automatically. For multiple attachments, use fileIndex (0 for the first imageFiles entry). Do not invent file IDs or ask for a public URL when attachment upload is available. Known fileId references and fetchable HTTP(S) sourceUrl imports also work. Carryo imports and hosts its own copy. Base64 image bytes and data URLs are unsupported. Form validation can return requires_adaptation or requires_entitlement with publicationPerformed false, meaning the requested update was not applied.

destructive

Argument	Type	Description
forms	array	Optional definitions for JavaScript/React forms using window.CarryoForms.submit(key, values), which resolves on acceptance and rejects on failure. Stable keys and field names identify forms across edits. Static collection forms are inferred from data-carryo-form="key" and named controls without duplicate definitions; placeholder submit handlers can block collection. Local calculator/filter forms use data-carryo-local and do not collect responses. Existing external endpoints retain their destination. Visitor acknowledgement is disabled unless explicitly enabled.
assets	array	Optional image assets to add or replace. Each entry requires a relative website path. With one imageFiles attachment, path alone uses that attachment. Otherwise select exactly one source: fileIndex (zero-based imageFiles position), a known fileId, or a fetchable HTTP(S) sourceUrl. Never guess generated file IDs. Existing images are preserved when omitted; replacing an existing path does not use another slot. Base64 bytes and data URLs are unsupported.

website.edit_images

Adds, replaces, or removes hosted images on an existing Carryo website without replacing its HTML. Reusing a path replaces that image without consuming another image slot; new paths are subject to the website image allowance. Returns hosted-image metadata and URLs. New paths appear in the page when referenced by its HTML. Pass attached images through imageFiles. For one attachment, assets needs only its relative website path; Carryo matches the attachment automatically. For multiple attachments, use fileIndex (0 for the first imageFiles entry). Do not invent file IDs or ask for a public URL when attachment upload is available. Known fileId references and fetchable HTTP(S) sourceUrl imports also work. Carryo imports and hosts its own copy. Base64 image bytes and data URLs are unsupported.

destructive

Argument	Type	Description
assets	array	Optional image assets to add or replace. Each entry requires a relative website path. With one imageFiles attachment, path alone uses that attachment. Otherwise select exactly one source: fileIndex (zero-based imageFiles position), a known fileId, or a fetchable HTTP(S) sourceUrl. Never guess generated file IDs. Existing images are preserved when omitted; replacing an existing path does not use another slot. Base64 bytes and data URLs are unsupported.
linkId*	string	Carryo page link identifier to update
imageFiles	array	Optional image attachments supplied through the host's file upload support. The host supplies file_id and download_url. Map each attachment to a website path in assets: with one attachment, path alone is sufficient; with multiple attachments, use fileIndex. The assistant does not need to know generated file IDs or download URLs. Temporary URLs are import sources, not hosted image URLs. Clients without file input support can omit this field.

website.library

Browse your Carryo websites and private drafts, select one, and continue editing in chat. Opening the library does not change or publish a website.

read-only

Argument	Type	Description
limit	integer
offset	integer
workspaceId	string	Optional exact workspaceId of the Carryo team selected by the user. Lists Personal websites when omitted.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    },
    "workspaceId": {
      "type": "string",
      "pattern": "^ws_[A-Za-z0-9]+$",
      "description": "Optional exact workspaceId of the Carryo team selected by the user. Lists Personal websites when omitted."
    }
  },
  "additionalProperties": false
}

website.list

Lists the connected account's Carryo websites and private drafts, with titles, linkIds, available live links, status, and effective edit and inactivity policies. Use it to find an existing website by name before reading or editing it. Listing does not change or publish websites. Returns Personal websites by default; workspaceId selects the user-chosen team's collection.

read-only

Argument	Type	Description
limit	integer
offset	integer
workspaceId	string	Optional exact workspaceId of the Carryo team selected by the user. Lists Personal websites when omitted.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    },
    "workspaceId": {
      "type": "string",
      "pattern": "^ws_[A-Za-z0-9]+$",
      "description": "Optional exact workspaceId of the Carryo team selected by the user. Lists Personal websites when omitted."
    }
  },
  "additionalProperties": false
}

website.list_versions

Lists previous versions of a Carryo website, including version details and changes, for reviewing edit history or planning a restoration. Returns version metadata without changing the website.

read-only

Argument	Type	Description
linkId*	string	Carryo page link identifier to inspect

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "linkId"
  ],
  "properties": {
    "linkId": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Carryo page link identifier to inspect"
    }
  },
  "additionalProperties": false
}

website.publish

Publishes supplied HTML as a new public Carryo website for sharing a presentation, proposal, report, dashboard, invitation, portfolio, or landing page. Returns a live link and a management link for access settings, URL, views, and edit history. New Personal websites consume the account creation allowance. Personal is the default destination; workspaceId selects a user-chosen team. Supports an optional customSlug and hosted images. Pass attached images through imageFiles. For one attachment, assets needs only its relative website path; Carryo matches the attachment automatically. For multiple attachments, use fileIndex (0 for the first imageFiles entry). Do not invent file IDs or ask for a public URL when attachment upload is available. Known fileId references and fetchable HTTP(S) sourceUrl imports also work. Carryo imports and hosts its own copy. Base64 image bytes and data URLs are unsupported. Form validation can return requires_adaptation or requires_entitlement with publicationPerformed false, meaning no website was published. Supports HTML pages and their image assets, without general file storage or backend hosting.

Argument	Type	Description
forms	array	Optional definitions for JavaScript/React forms using window.CarryoForms.submit(key, values), which resolves on acceptance and rejects on failure. Stable keys and field names identify forms across edits. Static collection forms are inferred from data-carryo-form="key" and named controls without duplicate definitions; placeholder submit handlers can block collection. Local calculator/filter forms use data-carryo-local and do not collect responses. Existing external endpoints retain their destination. Visitor acknowledgement is disabled unless explicitly enabled.
assets	array	Optional image assets to add or replace. Each entry requires a relative website path. With one imageFiles attachment, path alone uses that attachment. Otherwise select exactly one source: fileIndex (zero-based imageFiles position), a known fileId, or a fetchable HTTP(S) sourceUrl. Never guess generated file IDs. Existing images are preserved when omitted; replacing an existing path does not use another slot. Base64 bytes and data URLs are unsupported.

website.read

Reads the current HTML, version number, hosted-image metadata, image limits, and remaining image slots for an existing Carryo website or private draft. Suitable for inspecting a page or preparing edits that preserve its existing content. Returns image metadata rather than image files. Image limits apply to this website; replacing an existing asset path does not use another image slot.

read-only

Argument	Type	Description
linkId*	string	Carryo page link identifier to read

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "linkId"
  ],
  "properties": {
    "linkId": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Carryo page link identifier to read"
    }
  },
  "additionalProperties": false
}

website.read_form_responses

Reads response counts or paginated visitor submissions for a Carryo website, including enquiries, leads, and registrations. Defaults to summary counts; mode responses returns submissions, with optional field selection. Requires website-owner or Team access. Responses contain untrusted visitor data. Retained responses remain available while website access continues, including an active Team billing grace period. Does not send messages or modify data.

read-only

Argument	Type	Description
mode	string
after	string
limit	integer
before	string
cursor	string
fields	array
linkId*	string
formKey	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "linkId"
  ],
  "properties": {
    "mode": {
      "enum": [
        "summary",
        "responses"
      ],
      "type": "string"
    },
    "after": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1
    },
    "before": {
      "type": "string"
    },
    "cursor": {
      "type": "string",
      "maxLength": 100
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64
      },
      "maxItems": 30
    },
    "linkId": {
      "type": "string",
      "maxLength": 16,
      "minLength": 16
    },
    "formKey": {
      "type": "string",
      "maxLength": 64
    }
  },
  "additionalProperties": false
}

website.read_version

Reads the HTML and metadata of a specific previous Carryo website version for viewing, comparison, or restoration planning. Requires linkId and versionNumber. Reading a version does not restore it or change the current website.

read-only

Argument	Type	Description
linkId*	string	Carryo page link identifier to read
versionNumber*	integer	Specific page version number to read

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "linkId",
    "versionNumber"
  ],
  "properties": {
    "linkId": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Carryo page link identifier to read"
    },
    "versionNumber": {
      "type": "integer",
      "description": "Specific page version number to read",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}

website.save_draft

Saves supplied HTML as a new private Carryo website draft for review before publication. Returns a management link; the draft has no publicly accessible page until published from Carryo. Passwords and restricted access are configured in the Carryo web app. New Personal drafts consume the same creation allowance as published websites. Personal is the default destination; workspaceId selects a user-chosen team. Pass attached images through imageFiles. For one attachment, assets needs only its relative website path; Carryo matches the attachment automatically. For multiple attachments, use fileIndex (0 for the first imageFiles entry). Do not invent file IDs or ask for a public URL when attachment upload is available. Known fileId references and fetchable HTTP(S) sourceUrl imports also work. Carryo imports and hosts its own copy. Base64 image bytes and data URLs are unsupported. Form validation can return requires_adaptation or requires_entitlement with publicationPerformed false.

Argument	Type	Description
forms	array	Optional definitions for JavaScript/React forms using window.CarryoForms.submit(key, values), which resolves on acceptance and rejects on failure. Stable keys and field names identify forms across edits. Static collection forms are inferred from data-carryo-form="key" and named controls without duplicate definitions; placeholder submit handlers can block collection. Local calculator/filter forms use data-carryo-local and do not collect responses. Existing external endpoints retain their destination. Visitor acknowledgement is disabled unless explicitly enabled.
assets	array	Optional image assets to add or replace. Each entry requires a relative website path. With one imageFiles attachment, path alone uses that attachment. Otherwise select exactly one source: fileIndex (zero-based imageFiles position), a known fileId, or a fetchable HTTP(S) sourceUrl. Never guess generated file IDs. Existing images are preserved when omitted; replacing an existing path does not use another slot. Base64 bytes and data URLs are unsupported.

website.unpublish

Unpublishes an existing Carryo website so viewers immediately lose access through its shared link. Recovery availability depends on the website and is shown in Carryo. Unpublishing does not cancel a subscription.

destructive

Argument	Type	Description
linkId*	string	Carryo page link identifier to take offline

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "linkId"
  ],
  "properties": {
    "linkId": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Carryo page link identifier to take offline"
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "linkId",
    "htmlContent"
  ],
  "properties": {
    "forms": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "key",
          "title",
          "fields"
        ],
        "properties": {
          "key": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
          },
          "title": {
            "type": "string",
            "maxLength": 120,
            "minLength": 1
          },
          "closed": {
            "type": "boolean"
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "name",
                "label",
                "type"
              ],
              "properties": {
                "name": {
                  "type": "string",
                  "pattern": "^[a-z][a-z0-9_-]{0,63}$"
                },
                "type": {
                  "enum": [
                    "text",
                    "email",
                    "tel",
                    "number",
                    "date",
                    "textarea",
                    "select",
                    "checkbox",
                    "radio"
                  ],
                  "type": "string"
                },
                "label": {
                  "type": "string",
                  "maxLength": 120,
                  "minLength": 1
                },
                "options": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "maxLength": 200,
                    "minLength": 1
                  },
                  "maxItems": 100,
                  "minItems": 1
                },
                "required": {
                  "type": "boolean"
                },
                "maxLength": {
                  "type": "integer",
                  "maximum": 3000,
                  "minimum": 1
                }
              },
              "additionalProperties": false
            },
            "maxItems": 30,
            "minItems": 1
          },
          "notifyOwner": {
            "type": "boolean"
          },
          "acknowledgementEmailField": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 5,
      "description": "Optional definitions for JavaScript/React forms using window.CarryoForms.submit(key, values), which resolves on acceptance and rejects on failure. Stable keys and field names identify forms across edits. Static collection forms are inferred from data-carryo-form=\"key\" and named controls without duplicate definitions; placeholder submit handlers can block collection. Local calculator/filter forms use data-carryo-local and do not collect responses. Existing external endpoints retain their destination. Visitor acknowledgement is disabled unless explicitly enabled."
    },
    "assets": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "path"
        ],
        "properties": {
          "path": {
            "type": "string",
            "maxLength": 512,
            "minLength": 1
          },
          "fileId": {
            "type": "string",
            "maxLength": 512,
            "minLength": 1,
            "description": "Known attachment file_id matching an imageFiles entry. Prefer fileIndex if the host-generated ID is not visible. Mutually exclusive with fileIndex and sourceUrl."
          },
          "fileIndex": {
            "type": "integer",
            "maximum": 19,
            "minimum": 0,
            "description": "Zero-based position in imageFiles: 0 selects its first attachment. Use this when the host generates file IDs during upload. May be omitted when imageFiles contains exactly one attachment. Mutually exclusive with fileId and sourceUrl."
          },
          "sourceUrl": {
            "type": "string",
            "maxLength": 4096,
            "minLength": 1,
            "description": "Fetchable HTTP(S) image URL for Carryo to import and host. Mutually exclusive with fileId and fileIndex. Data URLs and base64 bytes are unsupported."
          },
          "contentType": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1
          }
        },
        "additionalProperties": false
      },
      "maxItems": 20,
      "description": "Optional image assets to add or replace. Each entry requires a relative website path. With one imageFiles attachment, path alone uses that attachment. Otherwise select exactly one source: fileIndex (zero-based imageFiles position), a known fileId, or a fetchable HTTP(S) sourceUrl. Never guess generated file IDs. Existing images are preserved when omitted; replacing an existing path does not use another slot. Base64 bytes and data URLs are unsupported."
    },
    "linkId": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Carryo page link identifier to update"
    },
    "fileName": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Optional replacement file name"
    },
    "expiresAt": {
      "type": "string",
      "description": "Optional ISO-8601 expiration timestamp"
    },
    "imageFiles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "download_url",
          "file_id"
        ],
        "properties": {
          "file_id": {
            "type": "string",
            "maxLength": 512,
            "minLength": 1
          },
          "file_name": {
            "type": "string",
            "maxLength": 1024,
            "minLength": 1
          },
          "mime_type": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1
          },
          "download_url": {
            "type": "string",
            "maxLength": 4096,
            "minLength": 1
          }
        },
        "additionalProperties": false
      },
      "maxItems": 20,
      "description": "Optional image attachments supplied through the host's file upload support. The host supplies file_id and download_url. Map each attachment to a website path in assets: with one attachment, path alone is sufficient; with multiple attachments, use fileIndex. The assistant does not need to know generated file IDs or download URLs. Temporary URLs are import sources, not hosted image URLs. Clients without file input support can omit this field."
    },
    "htmlContent": {
      "type": "string",
      "maxLength": 5242880,
      "minLength": 1,
      "description": "Updated complete HTML for the Carryo page while keeping the same URL."
    },
    "sharingMode": {
      "enum": [
        "public"
      ],
      "type": "string",
      "description": "Optional replacement publishing mode. Only public live links are supported here."
    },
    "removeAssetPaths": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 512,
        "minLength": 1
      },
      "maxItems": 20,
      "description": "Optional relative asset paths to remove from the page asset bundle."
    },
    "expectedVersionNumber": {
      "type": "integer",
      "description": "Expected current website version number for detecting conflicting edits.",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "linkId"
  ],
  "properties": {
    "assets": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "path"
        ],
        "properties": {
          "path": {
            "type": "string",
            "maxLength": 512,
            "minLength": 1
          },
          "fileId": {
            "type": "string",
            "maxLength": 512,
            "minLength": 1,
            "description": "Known attachment file_id matching an imageFiles entry. Prefer fileIndex if the host-generated ID is not visible. Mutually exclusive with fileIndex and sourceUrl."
          },
          "fileIndex": {
            "type": "integer",
            "maximum": 19,
            "minimum": 0,
            "description": "Zero-based position in imageFiles: 0 selects its first attachment. Use this when the host generates file IDs during upload. May be omitted when imageFiles contains exactly one attachment. Mutually exclusive with fileId and sourceUrl."
          },
          "sourceUrl": {
            "type": "string",
            "maxLength": 4096,
            "minLength": 1,
            "description": "Fetchable HTTP(S) image URL for Carryo to import and host. Mutually exclusive with fileId and fileIndex. Data URLs and base64 bytes are unsupported."
          },
          "contentType": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1
          }
        },
        "additionalProperties": false
      },
      "maxItems": 20,
      "description": "Optional image assets to add or replace. Each entry requires a relative website path. With one imageFiles attachment, path alone uses that attachment. Otherwise select exactly one source: fileIndex (zero-based imageFiles position), a known fileId, or a fetchable HTTP(S) sourceUrl. Never guess generated file IDs. Existing images are preserved when omitted; replacing an existing path does not use another slot. Base64 bytes and data URLs are unsupported."
    },
    "linkId": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Carryo page link identifier to update"
    },
    "imageFiles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "download_url",
          "file_id"
        ],
        "properties": {
          "file_id": {
            "type": "string",
            "maxLength": 512,
            "minLength": 1
          },
          "file_name": {
            "type": "string",
            "maxLength": 1024,
            "minLength": 1
          },
          "mime_type": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1
          },
          "download_url": {
            "type": "string",
            "maxLength": 4096,
            "minLength": 1
          }
        },
        "additionalProperties": false
      },
      "maxItems": 20,
      "description": "Optional image attachments supplied through the host's file upload support. The host supplies file_id and download_url. Map each attachment to a website path in assets: with one attachment, path alone is sufficient; with multiple attachments, use fileIndex. The assistant does not need to know generated file IDs or download URLs. Temporary URLs are import sources, not hosted image URLs. Clients without file input support can omit this field."
    },
    "removeAssetPaths": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 512,
        "minLength": 1
      },
      "maxItems": 20,
      "description": "Optional relative asset paths to remove from the page asset bundle."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "htmlContent",
    "fileName",
    "sharingMode"
  ],
  "properties": {
    "forms": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "key",
          "title",
          "fields"
        ],
        "properties": {
          "key": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
          },
          "title": {
            "type": "string",
            "maxLength": 120,
            "minLength": 1
          },
          "closed": {
            "type": "boolean"
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "name",
                "label",
                "type"
              ],
              "properties": {
                "name": {
                  "type": "string",
                  "pattern": "^[a-z][a-z0-9_-]{0,63}$"
                },
                "type": {
                  "enum": [
                    "text",
                    "email",
                    "tel",
                    "number",
                    "date",
                    "textarea",
                    "select",
                    "checkbox",
                    "radio"
                  ],
                  "type": "string"
                },
                "label": {
                  "type": "string",
                  "maxLength": 120,
                  "minLength": 1
                },
                "options": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "maxLength": 200,
                    "minLength": 1
                  },
                  "maxItems": 100,
                  "minItems": 1
                },
                "required": {
                  "type": "boolean"
                },
                "maxLength": {
                  "type": "integer",
                  "maximum": 3000,
                  "minimum": 1
                }
              },
              "additionalProperties": false
            },
            "maxItems": 30,
            "minItems": 1
          },
          "notifyOwner": {
            "type": "boolean"
          },
          "acknowledgementEmailField": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 5,
      "description": "Optional definitions for JavaScript/React forms using window.CarryoForms.submit(key, values), which resolves on acceptance and rejects on failure. Stable keys and field names identify forms across edits. Static collection forms are inferred from data-carryo-form=\"key\" and named controls without duplicate definitions; placeholder submit handlers can block collection. Local calculator/filter forms use data-carryo-local and do not collect responses. Existing external endpoints retain their destination. Visitor acknowledgement is disabled unless explicitly enabled."
    },
    "assets": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "path"
        ],
        "properties": {
          "path": {
            "type": "string",
            "maxLength": 512,
            "minLength": 1
          },
          "fileId": {
            "type": "string",
            "maxLength": 512,
            "minLength": 1,
            "description": "Known attachment file_id matching an imageFiles entry. Prefer fileIndex if the host-generated ID is not visible. Mutually exclusive with fileIndex and sourceUrl."
          },
          "fileIndex": {
            "type": "integer",
            "maximum": 19,
            "minimum": 0,
            "description": "Zero-based position in imageFiles: 0 selects its first attachment. Use this when the host generates file IDs during upload. May be omitted when imageFiles contains exactly one attachment. Mutually exclusive with fileId and sourceUrl."
          },
          "sourceUrl": {
            "type": "string",
            "maxLength": 4096,
            "minLength": 1,
            "description": "Fetchable HTTP(S) image URL for Carryo to import and host. Mutually exclusive with fileId and fileIndex. Data URLs and base64 bytes are unsupported."
          },
          "contentType": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1
          }
        },
        "additionalProperties": false
      },
      "maxItems": 20,
      "description": "Optional image assets to add or replace. Each entry requires a relative website path. With one imageFiles attachment, path alone uses that attachment. Otherwise select exactly one source: fileIndex (zero-based imageFiles position), a known fileId, or a fetchable HTTP(S) sourceUrl. Never guess generated file IDs. Existing images are preserved when omitted; replacing an existing path does not use another slot. Base64 bytes and data URLs are unsupported."
    },
    "fileName": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Short internal file name, for example client-proposal.html, board-deck.html, report.html, or landing-page.html."
    },
    "expiresAt": {
      "type": "string",
      "description": "Optional ISO-8601 expiration timestamp"
    },
    "customSlug": {
      "type": "string",
      "maxLength": 64,
      "minLength": 3,
      "description": "Optional user-chosen URL ending using lowercase letters, numbers, and hyphens. An automatic URL is generated when omitted."
    },
    "imageFiles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "download_url",
          "file_id"
        ],
        "properties": {
          "file_id": {
            "type": "string",
            "maxLength": 512,
            "minLength": 1
          },
          "file_name": {
            "type": "string",
            "maxLength": 1024,
            "minLength": 1
          },
          "mime_type": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1
          },
          "download_url": {
            "type": "string",
            "maxLength": 4096,
            "minLength": 1
          }
        },
        "additionalProperties": false
      },
      "maxItems": 20,
      "description": "Optional image attachments supplied through the host's file upload support. The host supplies file_id and download_url. Map each attachment to a website path in assets: with one attachment, path alone is sufficient; with multiple attachments, use fileIndex. The assistant does not need to know generated file IDs or download URLs. Temporary URLs are import sources, not hosted image URLs. Clients without file input support can omit this field."
    },
    "htmlContent": {
      "type": "string",
      "maxLength": 5242880,
      "minLength": 1,
      "description": "Complete HTML for the page, presentation, slide deck, proposal, report, landing page, dashboard, invitation, portfolio, or one-page website to publish."
    },
    "sharingMode": {
      "enum": [
        "public"
      ],
      "type": "string",
      "description": "Publishing mode for the Carryo page. Only public live links are supported here."
    },
    "workspaceId": {
      "type": "string",
      "pattern": "^ws_[A-Za-z0-9]+$",
      "description": "Optional exact workspaceId of the Carryo team explicitly selected by the user. The default destination is Personal when omitted."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "htmlContent",
    "fileName"
  ],
  "properties": {
    "forms": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "key",
          "title",
          "fields"
        ],
        "properties": {
          "key": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9_-]{0,63}$"
          },
          "title": {
            "type": "string",
            "maxLength": 120,
            "minLength": 1
          },
          "closed": {
            "type": "boolean"
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "name",
                "label",
                "type"
              ],
              "properties": {
                "name": {
                  "type": "string",
                  "pattern": "^[a-z][a-z0-9_-]{0,63}$"
                },
                "type": {
                  "enum": [
                    "text",
                    "email",
                    "tel",
                    "number",
                    "date",
                    "textarea",
                    "select",
                    "checkbox",
                    "radio"
                  ],
                  "type": "string"
                },
                "label": {
                  "type": "string",
                  "maxLength": 120,
                  "minLength": 1
                },
                "options": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "maxLength": 200,
                    "minLength": 1
                  },
                  "maxItems": 100,
                  "minItems": 1
                },
                "required": {
                  "type": "boolean"
                },
                "maxLength": {
                  "type": "integer",
                  "maximum": 3000,
                  "minimum": 1
                }
              },
              "additionalProperties": false
            },
            "maxItems": 30,
            "minItems": 1
          },
          "notifyOwner": {
            "type": "boolean"
          },
          "acknowledgementEmailField": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 5,
      "description": "Optional definitions for JavaScript/React forms using window.CarryoForms.submit(key, values), which resolves on acceptance and rejects on failure. Stable keys and field names identify forms across edits. Static collection forms are inferred from data-carryo-form=\"key\" and named controls without duplicate definitions; placeholder submit handlers can block collection. Local calculator/filter forms use data-carryo-local and do not collect responses. Existing external endpoints retain their destination. Visitor acknowledgement is disabled unless explicitly enabled."
    },
    "assets": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "path"
        ],
        "properties": {
          "path": {
            "type": "string",
            "maxLength": 512,
            "minLength": 1
          },
          "fileId": {
            "type": "string",
            "maxLength": 512,
            "minLength": 1,
            "description": "Known attachment file_id matching an imageFiles entry. Prefer fileIndex if the host-generated ID is not visible. Mutually exclusive with fileIndex and sourceUrl."
          },
          "fileIndex": {
            "type": "integer",
            "maximum": 19,
            "minimum": 0,
            "description": "Zero-based position in imageFiles: 0 selects its first attachment. Use this when the host generates file IDs during upload. May be omitted when imageFiles contains exactly one attachment. Mutually exclusive with fileId and sourceUrl."
          },
          "sourceUrl": {
            "type": "string",
            "maxLength": 4096,
            "minLength": 1,
            "description": "Fetchable HTTP(S) image URL for Carryo to import and host. Mutually exclusive with fileId and fileIndex. Data URLs and base64 bytes are unsupported."
          },
          "contentType": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1
          }
        },
        "additionalProperties": false
      },
      "maxItems": 20,
      "description": "Optional image assets to add or replace. Each entry requires a relative website path. With one imageFiles attachment, path alone uses that attachment. Otherwise select exactly one source: fileIndex (zero-based imageFiles position), a known fileId, or a fetchable HTTP(S) sourceUrl. Never guess generated file IDs. Existing images are preserved when omitted; replacing an existing path does not use another slot. Base64 bytes and data URLs are unsupported."
    },
    "fileName": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Short internal file name, for example client-proposal.html, board-deck.html, report.html, or landing-page.html."
    },
    "expiresAt": {
      "type": "string",
      "description": "Optional ISO-8601 expiration timestamp"
    },
    "customSlug": {
      "type": "string",
      "maxLength": 64,
      "minLength": 3,
      "description": "Optional user-chosen URL ending using lowercase letters, numbers, and hyphens. An automatic URL is generated when omitted."
    },
    "imageFiles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "download_url",
          "file_id"
        ],
        "properties": {
          "file_id": {
            "type": "string",
            "maxLength": 512,
            "minLength": 1
          },
          "file_name": {
            "type": "string",
            "maxLength": 1024,
            "minLength": 1
          },
          "mime_type": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1
          },
          "download_url": {
            "type": "string",
            "maxLength": 4096,
            "minLength": 1
          }
        },
        "additionalProperties": false
      },
      "maxItems": 20,
      "description": "Optional image attachments supplied through the host's file upload support. The host supplies file_id and download_url. Map each attachment to a website path in assets: with one attachment, path alone is sufficient; with multiple attachments, use fileIndex. The assistant does not need to know generated file IDs or download URLs. Temporary URLs are import sources, not hosted image URLs. Clients without file input support can omit this field."
    },
    "htmlContent": {
      "type": "string",
      "maxLength": 5242880,
      "minLength": 1,
      "description": "Complete HTML for the private Carryo draft page, presentation, slide deck, proposal, report, landing page, dashboard, invitation, portfolio, or one-page website."
    },
    "workspaceId": {
      "type": "string",
      "pattern": "^ws_[A-Za-z0-9]+$",
      "description": "Optional exact workspaceId of the Carryo team explicitly selected by the user. The default destination is Personal when omitted."
    }
  },
  "additionalProperties": false
}