Server definition
- Hash
- sha256:addfc1e9aef555d3b4beeb95d9e6afdaa2a08594665f27ba520e441ee8dc446a
- What it is
- What a remote MCP server returned when asked what it offers: 13 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "account.check_publishing",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"capabilities": {
"additionalProperties": false,
"description": "Personal default capabilities. Use websiteOverrides for the named websites, not for the whole account",
"properties": {
"canCollectFormResponses": {
"description": "Whether Personal forms can currently collect responses; Team access is resolved from the website",
"type": "boolean"
},
"canCustomizePasswordPage": {
"description": "Whether password pages can use custom branding in Carryo",
"type": "boolean"
},
"canHideCarryoBadge": {
"description": "Whether the Carryo badge can be hidden in Carryo settings",
"type": "boolean"
},
"canPublishLink": {
"description": "Whether another Personal link can be published now",
"type": "boolean"
},
"canUseCustomUrlEnding": {
"description": "Whether a custom Carryo URL ending can be used",
"type": "boolean"
},
"linksStayOnlineWithoutActivity": {
"description": "Whether links stay online without periodic owner activity",
"type": "boolean"
}
},
"required": [
"canPublishLink",
"canUseCustomUrlEnding",
"canCustomizePasswordPage",
"canHideCarryoBadge",
"linksStayOnlineWithoutActivity"
],
"type": "object"
},
"limits": {
"additionalProperties": false,
"description": "Personal default policies; websiteOverrides takes precedence for the named websites",
"properties": {
"imagesPerSite": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Default hosted-image count per Personal website; matching websiteOverrides takes precedence"
},
"inactivityWindowDays": {
"description": "Days after the owner last acts in Carryo before a link is taken offline; null when inactivity does not apply",
"type": [
"number",
"null"
]
},
"revokedRecoveryDays": {
"description": "Default recovery period after inactivity; manual unpublishing may not be reversible. Check the website policy and Carryo settings",
"type": "number"
},
"updatesPerLink": {
"description": "Maximum updates per link, or null for unlimited",
"type": [
"number",
"null"
]
}
},
"required": [
"updatesPerLink",
"inactivityWindowDays",
"revokedRecoveryDays"
],
"type": "object"
},
"usage": {
"additionalProperties": false,
"description": "Personal link usage needed to answer the current action",
"properties": {
"activeLinkLimit": {
"description": "Maximum active Personal links, or null when no product limit applies",
"type": [
"number",
"null"
]
},
"activeLinks": {
"description": "Current number of active Personal links",
"type": "number"
},
"newLinkLimit": {
"description": "Maximum new Personal links in the current period, or null when no creation limit applies",
"type": [
"number",
"null"
]
},
"newLinksResetAt": {
"description": "ISO-8601 time when the Personal creation allowance resets, or null when no creation limit applies",
"type": [
"string",
"null"
]
},
"newLinksThisPeriod": {
"description": "New Personal links created or claimed in the current creation period",
"type": "number"
},
"remainingActiveLinks": {
"description": "How many more Personal links can be published now, or null when no product limit applies",
"type": [
"number",
"null"
]
},
"remainingNewLinks": {
"description": "New Personal links still available in the current period, or null when no creation limit applies",
"type": [
"number",
"null"
]
}
},
"required": [
"activeLinks",
"activeLinkLimit",
"remainingActiveLinks",
"newLinksThisPeriod",
"newLinkLimit",
"remainingNewLinks",
"newLinksResetAt"
],
"type": "object"
},
"websiteOverrides": {
"description": "Website-specific exceptions to Personal defaults. Explicit owner-set expiry and unpublishing still apply",
"items": {
"additionalProperties": false,
"properties": {
"canHideCarryoBadge": {
"description": "Whether this website can hide its badge in Carryo settings; removal is not automatic",
"type": "boolean"
},
"canUseCustomDomain": {
"description": "Whether this website can use a custom domain configured in Carryo",
"type": "boolean"
},
"imagesPerSite": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "Maximum hosted images on this website; null means no plan-specific count limit"
},
"inactivityWindowDays": {
"description": "Owner-inactivity window for this website; null means no inactivity expiry",
"type": [
"number",
"null"
]
},
"linkId": {
"description": "The website this exception applies to; never apply it to other websites",
"type": "string"
},
"updatesPerLink": {
"description": "Update limit for this website; null means unlimited subject to fair use",
"type": [
"number",
"null"
]
}
},
"required": [
"linkId",
"updatesPerLink",
"inactivityWindowDays",
"canHideCarryoBadge",
"canUseCustomDomain"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"capabilities",
"usage",
"limits"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "team.list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"workspaces": {
"description": "Carryo workspaces the authenticated user can access",
"items": {
"additionalProperties": false,
"properties": {
"capabilities": {
"additionalProperties": false,
"description": "Workspace actions currently available to the authenticated user",
"properties": {
"canListLinks": {
"description": "Whether workspace links can be listed",
"type": "boolean"
},
"canPublishLinks": {
"description": "Whether new workspace links can be published",
"type": "boolean"
},
"canRevokeLinks": {
"description": "Whether workspace links can be revoked",
"type": "boolean"
},
"canUpdateLinks": {
"description": "Whether workspace links can be updated",
"type": "boolean"
}
},
"required": [
"canListLinks",
"canPublishLinks",
"canUpdateLinks",
"canRevokeLinks"
],
"type": "object"
},
"role": {
"description": "The authenticated user role in this workspace",
"enum": [
"owner",
"editor"
],
"type": "string"
},
"workspaceId": {
"description": "Stable Carryo workspace identifier to use in later tool calls",
"type": "string"
},
"workspaceName": {
"description": "User-facing Carryo workspace name",
"type": "string"
}
},
"required": [
"workspaceId",
"workspaceName",
"role",
"capabilities"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"workspaces"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assets": {
"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.",
"items": {
"additionalProperties": false,
"properties": {
"contentType": {
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"fileId": {
"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.",
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"fileIndex": {
"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.",
"maximum": 19,
"minimum": 0,
"type": "integer"
},
"path": {
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"sourceUrl": {
"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.",
"maxLength": 4096,
"minLength": 1,
"type": "string"
}
},
"required": [
"path"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"expectedVersionNumber": {
"description": "Expected current website version number for detecting conflicting edits.",
"exclusiveMinimum": 0,
"type": "integer"
},
"expiresAt": {
"description": "Optional ISO-8601 expiration timestamp",
"type": "string"
},
"fileName": {
"description": "Optional replacement file name",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"forms": {
"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.",
"items": {
"additionalProperties": false,
"properties": {
"acknowledgementEmailField": {
"type": "string"
},
"closed": {
"type": "boolean"
},
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"maxLength": {
"maximum": 3000,
"minimum": 1,
"type": "integer"
},
"name": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"options": {
"items": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
},
"required": {
"type": "boolean"
},
"type": {
"enum": [
"text",
"email",
"tel",
"number",
"date",
"textarea",
"select",
"checkbox",
"radio"
],
"type": "string"
}
},
"required": [
"name",
"label",
"type"
],
"type": "object"
},
"maxItems": 30,
"minItems": 1,
"type": "array"
},
"key": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"notifyOwner": {
"type": "boolean"
},
"title": {
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"key",
"title",
"fields"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
},
"htmlContent": {
"description": "Updated complete HTML for the Carryo page while keeping the same URL.",
"maxLength": 5242880,
"minLength": 1,
"type": "string"
},
"imageFiles": {
"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.",
"items": {
"additionalProperties": false,
"properties": {
"download_url": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"file_id": {
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"file_name": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"mime_type": {
"maxLength": 255,
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"linkId": {
"description": "Carryo page link identifier to update",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"removeAssetPaths": {
"description": "Optional relative asset paths to remove from the page asset bundle.",
"items": {
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"sharingMode": {
"description": "Optional replacement publishing mode. Only public live links are supported here.",
"enum": [
"public"
],
"type": "string"
}
},
"required": [
"linkId",
"htmlContent"
],
"type": "object"
},
"name": "website.edit",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"alternateShareUrls": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Alternate share URLs, when available"
},
"code": {
"type": "string"
},
"currentVersionNumber": {
"type": "number"
},
"expiresAt": {
"$ref": "#/properties/manageUrl",
"description": "Optional ISO-8601 expiration timestamp"
},
"forms": {
"items": {
"additionalProperties": false,
"properties": {
"acknowledgementEmailField": {
"type": "string"
},
"closed": {
"type": "boolean"
},
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"maxLength": {
"maximum": 3000,
"minimum": 1,
"type": "integer"
},
"name": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"options": {
"items": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
},
"required": {
"type": "boolean"
},
"type": {
"enum": [
"text",
"email",
"tel",
"number",
"date",
"textarea",
"select",
"checkbox",
"radio"
],
"type": "string"
}
},
"required": [
"name",
"label",
"type"
],
"type": "object"
},
"maxItems": 30,
"minItems": 1,
"type": "array"
},
"key": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"notifications": {
"enum": [
"enabled",
"disabled",
"unavailable"
],
"type": "string"
},
"notifyOwner": {
"type": "boolean"
},
"retentionDays": {
"type": "number"
},
"revision": {
"type": "number"
},
"state": {
"enum": [
"active",
"draft",
"closed",
"unavailable"
],
"type": "string"
},
"title": {
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"key",
"title",
"fields",
"revision",
"state",
"retentionDays",
"notifications"
],
"type": "object"
},
"type": "array"
},
"guidance": {
"additionalProperties": {},
"type": "object"
},
"linkId": {
"description": "Carryo page link identifier",
"type": "string"
},
"manageUrl": {
"description": "Carryo web-app URL for managing the link URL, password, views, and edit history",
"type": [
"string",
"null"
]
},
"message": {
"type": "string"
},
"publicationPerformed": {
"const": false,
"type": "boolean"
},
"shareUrl": {
"description": "Primary share URL",
"type": "string"
},
"status": {
"enum": [
"requires_adaptation",
"requires_entitlement",
"unsupported",
"unavailable"
],
"type": "string"
},
"updatedAt": {
"description": "ISO-8601 update timestamp",
"type": "string"
},
"workspaceId": {
"$ref": "#/properties/manageUrl",
"description": "Workspace that owns the link; omitted for Personal"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assets": {
"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.",
"items": {
"additionalProperties": false,
"properties": {
"contentType": {
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"fileId": {
"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.",
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"fileIndex": {
"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.",
"maximum": 19,
"minimum": 0,
"type": "integer"
},
"path": {
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"sourceUrl": {
"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.",
"maxLength": 4096,
"minLength": 1,
"type": "string"
}
},
"required": [
"path"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"imageFiles": {
"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.",
"items": {
"additionalProperties": false,
"properties": {
"download_url": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"file_id": {
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"file_name": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"mime_type": {
"maxLength": 255,
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"linkId": {
"description": "Carryo page link identifier to update",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"removeAssetPaths": {
"description": "Optional relative asset paths to remove from the page asset bundle.",
"items": {
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"linkId"
],
"type": "object"
},
"name": "website.edit_images",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assetUrls": {
"description": "URLs for added or replaced assets",
"items": {
"additionalProperties": false,
"properties": {
"assetUrl": {
"description": "Relative URL where the page serves this asset",
"type": "string"
},
"path": {
"description": "Relative asset path",
"type": "string"
}
},
"required": [
"path",
"assetUrl"
],
"type": "object"
},
"type": "array"
},
"code": {
"type": "string"
},
"currentVersionNumber": {
"type": "number"
},
"forms": {
"items": {
"additionalProperties": false,
"properties": {
"acknowledgementEmailField": {
"type": "string"
},
"closed": {
"type": "boolean"
},
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"maxLength": {
"maximum": 3000,
"minimum": 1,
"type": "integer"
},
"name": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"options": {
"items": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
},
"required": {
"type": "boolean"
},
"type": {
"enum": [
"text",
"email",
"tel",
"number",
"date",
"textarea",
"select",
"checkbox",
"radio"
],
"type": "string"
}
},
"required": [
"name",
"label",
"type"
],
"type": "object"
},
"maxItems": 30,
"minItems": 1,
"type": "array"
},
"key": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"notifications": {
"enum": [
"enabled",
"disabled",
"unavailable"
],
"type": "string"
},
"notifyOwner": {
"type": "boolean"
},
"retentionDays": {
"type": "number"
},
"revision": {
"type": "number"
},
"state": {
"enum": [
"active",
"draft",
"closed",
"unavailable"
],
"type": "string"
},
"title": {
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"key",
"title",
"fields",
"revision",
"state",
"retentionDays",
"notifications"
],
"type": "object"
},
"type": "array"
},
"guidance": {
"additionalProperties": {},
"type": "object"
},
"linkId": {
"description": "Carryo page link identifier",
"type": "string"
},
"message": {
"type": "string"
},
"publicationPerformed": {
"const": false,
"type": "boolean"
},
"shareUrl": {
"description": "Primary share URL",
"type": "string"
},
"status": {
"enum": [
"requires_adaptation",
"requires_entitlement",
"unsupported",
"unavailable"
],
"type": "string"
},
"updatedAt": {
"description": "ISO-8601 update timestamp",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Browse your Carryo websites and private drafts, select one, and continue editing in chat. Opening the library does not change or publish a website.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"offset": {
"minimum": 0,
"type": "integer"
},
"workspaceId": {
"description": "Optional exact workspaceId of the Carryo team selected by the user. Lists Personal websites when omitted.",
"pattern": "^ws_[A-Za-z0-9]+$",
"type": "string"
}
},
"type": "object"
},
"name": "website.library",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"artifacts": {
"description": "Carryo pages owned by the authenticated user",
"items": {
"additionalProperties": false,
"properties": {
"accessMode": {
"description": "Whether the page is public or restricted",
"enum": [
"public",
"restricted"
],
"type": "string"
},
"alternateShareUrls": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Alternate share URLs, when available"
},
"customSlug": {
"$ref": "#/properties/workspaceId",
"description": "Optional custom URL ending"
},
"expiresAt": {
"$ref": "#/properties/workspaceId",
"description": "Optional ISO-8601 expiration timestamp"
},
"fileName": {
"description": "Page file name",
"type": "string"
},
"isRevoked": {
"description": "Whether the share link has been revoked",
"type": "boolean"
},
"linkId": {
"description": "Carryo page link identifier",
"type": "string"
},
"manageUrl": {
"$ref": "#/properties/workspaceId",
"description": "Carryo management URL for private drafts"
},
"policies": {
"additionalProperties": false,
"description": "Actual per-website policy; use this instead of Personal account defaults",
"properties": {
"canReactivate": {
"description": "Whether restoration is currently supported in Carryo, subject to available capacity",
"type": "boolean"
},
"inactivityRevokesAt": {
"$ref": "#/properties/workspaceId",
"description": "Inactivity deadline; a separately set expiresAt can take the website offline earlier"
},
"inactivityWindowDays": {
"description": "Days since this website’s last owner edit or Keep live action; null means no inactivity expiry. Views and sign-in do not renew it",
"type": [
"number",
"null"
]
},
"updatesPerLink": {
"description": "This website’s update limit; null means unlimited subject to fair use",
"type": [
"number",
"null"
]
}
},
"required": [
"updatesPerLink",
"inactivityWindowDays",
"canReactivate"
],
"type": "object"
},
"publicationState": {
"description": "Whether the page is a private draft or published",
"enum": [
"draft",
"published"
],
"type": "string"
},
"shareUrl": {
"$ref": "#/properties/workspaceId",
"description": "Primary share URL, omitted for private drafts"
}
},
"required": [
"linkId",
"fileName",
"publicationState",
"accessMode",
"isRevoked"
],
"type": "object"
},
"type": "array"
},
"limit": {
"description": "Pagination limit used by the response",
"type": "number"
},
"offset": {
"description": "Pagination offset used by the response",
"type": "number"
},
"total": {
"description": "Total page count before pagination",
"type": "number"
},
"workspaceId": {
"description": "Workspace whose links were listed; omitted for Personal",
"type": [
"string",
"null"
]
},
"workspaces": {
"description": "Carryo workspaces the authenticated user can access",
"items": {
"additionalProperties": false,
"properties": {
"capabilities": {
"additionalProperties": false,
"description": "Workspace actions currently available to the authenticated user",
"properties": {
"canListLinks": {
"description": "Whether workspace links can be listed",
"type": "boolean"
},
"canPublishLinks": {
"description": "Whether new workspace links can be published",
"type": "boolean"
},
"canRevokeLinks": {
"description": "Whether workspace links can be revoked",
"type": "boolean"
},
"canUpdateLinks": {
"description": "Whether workspace links can be updated",
"type": "boolean"
}
},
"required": [
"canListLinks",
"canPublishLinks",
"canUpdateLinks",
"canRevokeLinks"
],
"type": "object"
},
"role": {
"description": "The authenticated user role in this workspace",
"enum": [
"owner",
"editor"
],
"type": "string"
},
"workspaceId": {
"description": "Stable Carryo workspace identifier to use in later tool calls",
"type": "string"
},
"workspaceName": {
"description": "User-facing Carryo workspace name",
"type": "string"
}
},
"required": [
"workspaceId",
"workspaceName",
"role",
"capabilities"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"artifacts",
"total",
"limit",
"offset",
"workspaces"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"offset": {
"minimum": 0,
"type": "integer"
},
"workspaceId": {
"description": "Optional exact workspaceId of the Carryo team selected by the user. Lists Personal websites when omitted.",
"pattern": "^ws_[A-Za-z0-9]+$",
"type": "string"
}
},
"type": "object"
},
"name": "website.list",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"artifacts": {
"description": "Carryo pages owned by the authenticated user",
"items": {
"additionalProperties": false,
"properties": {
"accessMode": {
"description": "Whether the page is public or restricted",
"enum": [
"public",
"restricted"
],
"type": "string"
},
"alternateShareUrls": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Alternate share URLs, when available"
},
"customSlug": {
"$ref": "#/properties/workspaceId",
"description": "Optional custom URL ending"
},
"expiresAt": {
"$ref": "#/properties/workspaceId",
"description": "Optional ISO-8601 expiration timestamp"
},
"fileName": {
"description": "Page file name",
"type": "string"
},
"isRevoked": {
"description": "Whether the share link has been revoked",
"type": "boolean"
},
"linkId": {
"description": "Carryo page link identifier",
"type": "string"
},
"manageUrl": {
"$ref": "#/properties/workspaceId",
"description": "Carryo management URL for private drafts"
},
"policies": {
"additionalProperties": false,
"description": "Actual per-website policy; use this instead of Personal account defaults",
"properties": {
"canReactivate": {
"description": "Whether restoration is currently supported in Carryo, subject to available capacity",
"type": "boolean"
},
"inactivityRevokesAt": {
"$ref": "#/properties/workspaceId",
"description": "Inactivity deadline; a separately set expiresAt can take the website offline earlier"
},
"inactivityWindowDays": {
"description": "Days since this website’s last owner edit or Keep live action; null means no inactivity expiry. Views and sign-in do not renew it",
"type": [
"number",
"null"
]
},
"updatesPerLink": {
"description": "This website’s update limit; null means unlimited subject to fair use",
"type": [
"number",
"null"
]
}
},
"required": [
"updatesPerLink",
"inactivityWindowDays",
"canReactivate"
],
"type": "object"
},
"publicationState": {
"description": "Whether the page is a private draft or published",
"enum": [
"draft",
"published"
],
"type": "string"
},
"shareUrl": {
"$ref": "#/properties/workspaceId",
"description": "Primary share URL, omitted for private drafts"
}
},
"required": [
"linkId",
"fileName",
"publicationState",
"accessMode",
"isRevoked"
],
"type": "object"
},
"type": "array"
},
"limit": {
"description": "Pagination limit used by the response",
"type": "number"
},
"offset": {
"description": "Pagination offset used by the response",
"type": "number"
},
"total": {
"description": "Total page count before pagination",
"type": "number"
},
"workspaceId": {
"description": "Workspace whose links were listed; omitted for Personal",
"type": [
"string",
"null"
]
}
},
"required": [
"artifacts",
"total",
"limit",
"offset"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"linkId": {
"description": "Carryo page link identifier to inspect",
"maxLength": 255,
"minLength": 1,
"type": "string"
}
},
"required": [
"linkId"
],
"type": "object"
},
"name": "website.list_versions",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"currentVersionNumber": {
"description": "Current page version number",
"type": "number"
},
"linkId": {
"description": "Carryo page link identifier",
"type": "string"
},
"versions": {
"description": "Page version history",
"items": {
"additionalProperties": false,
"properties": {
"accessMode": {
"description": "Whether the version was public or restricted",
"enum": [
"public",
"restricted"
],
"type": "string"
},
"assetBytes": {
"description": "Total bundled asset size in bytes",
"type": "number"
},
"assetChanges": {
"description": "Asset changes in this version",
"items": {
"additionalProperties": false,
"properties": {
"action": {
"description": "Asset change type",
"enum": [
"added",
"updated",
"removed",
"retained"
],
"type": "string"
},
"contentType": {
"description": "Optional MIME type for the asset",
"type": [
"string",
"null"
]
},
"path": {
"description": "Relative asset path that changed",
"type": "string"
},
"previousSizeBytes": {
"description": "Previous asset size in bytes",
"type": [
"number",
"null"
]
},
"sizeBytes": {
"description": "Current asset size in bytes",
"type": [
"number",
"null"
]
}
},
"required": [
"path",
"action"
],
"type": "object"
},
"type": "array"
},
"assetCount": {
"description": "Number of bundled assets in this version",
"type": "number"
},
"changeSummary": {
"$ref": "#/properties/versions/items/properties/assetChanges/items/properties/contentType",
"description": "Optional human-readable version change summary"
},
"createdAt": {
"description": "ISO-8601 timestamp when this version was created",
"type": "string"
},
"eventType": {
"description": "Version event type",
"enum": [
"created",
"updated",
"legacy_current"
],
"type": "string"
},
"fileName": {
"description": "Page file name for this version",
"type": "string"
},
"isCurrent": {
"description": "Whether this is the page current version",
"type": "boolean"
},
"linkId": {
"description": "Carryo page link identifier",
"type": "string"
},
"sizeBytes": {
"description": "HTML content size in bytes",
"type": "number"
},
"versionNumber": {
"description": "Page version number",
"type": "number"
}
},
"required": [
"linkId",
"versionNumber",
"eventType",
"createdAt",
"fileName",
"accessMode",
"sizeBytes",
"assetCount",
"assetBytes",
"assetChanges",
"isCurrent"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"linkId",
"currentVersionNumber",
"versions"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assets": {
"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.",
"items": {
"additionalProperties": false,
"properties": {
"contentType": {
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"fileId": {
"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.",
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"fileIndex": {
"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.",
"maximum": 19,
"minimum": 0,
"type": "integer"
},
"path": {
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"sourceUrl": {
"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.",
"maxLength": 4096,
"minLength": 1,
"type": "string"
}
},
"required": [
"path"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"customSlug": {
"description": "Optional user-chosen URL ending using lowercase letters, numbers, and hyphens. An automatic URL is generated when omitted.",
"maxLength": 64,
"minLength": 3,
"type": "string"
},
"expiresAt": {
"description": "Optional ISO-8601 expiration timestamp",
"type": "string"
},
"fileName": {
"description": "Short internal file name, for example client-proposal.html, board-deck.html, report.html, or landing-page.html.",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"forms": {
"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.",
"items": {
"additionalProperties": false,
"properties": {
"acknowledgementEmailField": {
"type": "string"
},
"closed": {
"type": "boolean"
},
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"maxLength": {
"maximum": 3000,
"minimum": 1,
"type": "integer"
},
"name": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"options": {
"items": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
},
"required": {
"type": "boolean"
},
"type": {
"enum": [
"text",
"email",
"tel",
"number",
"date",
"textarea",
"select",
"checkbox",
"radio"
],
"type": "string"
}
},
"required": [
"name",
"label",
"type"
],
"type": "object"
},
"maxItems": 30,
"minItems": 1,
"type": "array"
},
"key": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"notifyOwner": {
"type": "boolean"
},
"title": {
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"key",
"title",
"fields"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
},
"htmlContent": {
"description": "Complete HTML for the page, presentation, slide deck, proposal, report, landing page, dashboard, invitation, portfolio, or one-page website to publish.",
"maxLength": 5242880,
"minLength": 1,
"type": "string"
},
"imageFiles": {
"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.",
"items": {
"additionalProperties": false,
"properties": {
"download_url": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"file_id": {
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"file_name": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"mime_type": {
"maxLength": 255,
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"sharingMode": {
"description": "Publishing mode for the Carryo page. Only public live links are supported here.",
"enum": [
"public"
],
"type": "string"
},
"workspaceId": {
"description": "Optional exact workspaceId of the Carryo team explicitly selected by the user. The default destination is Personal when omitted.",
"pattern": "^ws_[A-Za-z0-9]+$",
"type": "string"
}
},
"required": [
"htmlContent",
"fileName",
"sharingMode"
],
"type": "object"
},
"name": "website.publish",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"alternateShareUrls": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Alternate share URLs, when available"
},
"code": {
"type": "string"
},
"currentVersionNumber": {
"type": "number"
},
"customSlug": {
"description": "Optional custom URL ending",
"type": [
"string",
"null"
]
},
"expiresAt": {
"$ref": "#/properties/customSlug",
"description": "Optional ISO-8601 expiration timestamp"
},
"forms": {
"items": {
"additionalProperties": false,
"properties": {
"acknowledgementEmailField": {
"type": "string"
},
"closed": {
"type": "boolean"
},
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"maxLength": {
"maximum": 3000,
"minimum": 1,
"type": "integer"
},
"name": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"options": {
"items": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
},
"required": {
"type": "boolean"
},
"type": {
"enum": [
"text",
"email",
"tel",
"number",
"date",
"textarea",
"select",
"checkbox",
"radio"
],
"type": "string"
}
},
"required": [
"name",
"label",
"type"
],
"type": "object"
},
"maxItems": 30,
"minItems": 1,
"type": "array"
},
"key": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"notifications": {
"enum": [
"enabled",
"disabled",
"unavailable"
],
"type": "string"
},
"notifyOwner": {
"type": "boolean"
},
"retentionDays": {
"type": "number"
},
"revision": {
"type": "number"
},
"state": {
"enum": [
"active",
"draft",
"closed",
"unavailable"
],
"type": "string"
},
"title": {
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"key",
"title",
"fields",
"revision",
"state",
"retentionDays",
"notifications"
],
"type": "object"
},
"type": "array"
},
"guidance": {
"additionalProperties": {},
"type": "object"
},
"linkId": {
"description": "Carryo page link identifier",
"type": "string"
},
"manageUrl": {
"$ref": "#/properties/customSlug",
"description": "Carryo web-app URL for managing the link URL, password, views, and edit history"
},
"message": {
"type": "string"
},
"publicationPerformed": {
"const": false,
"type": "boolean"
},
"shareUrl": {
"description": "Primary share URL",
"type": "string"
},
"status": {
"enum": [
"requires_adaptation",
"requires_entitlement",
"unsupported",
"unavailable"
],
"type": "string"
},
"workspaceId": {
"$ref": "#/properties/customSlug",
"description": "Workspace that owns the link; omitted for Personal"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"linkId": {
"description": "Carryo page link identifier to read",
"maxLength": 255,
"minLength": 1,
"type": "string"
}
},
"required": [
"linkId"
],
"type": "object"
},
"name": "website.read",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assets": {
"description": "Bundled asset descriptors",
"items": {
"additionalProperties": false,
"properties": {
"contentType": {
"description": "Asset MIME type",
"type": "string"
},
"path": {
"description": "Relative asset path in the page asset bundle",
"type": "string"
},
"sizeBytes": {
"description": "Asset size in bytes",
"type": "number"
}
},
"required": [
"path",
"contentType",
"sizeBytes"
],
"type": "object"
},
"type": "array"
},
"currentVersionNumber": {
"type": "number"
},
"forms": {
"items": {
"additionalProperties": false,
"properties": {
"acknowledgementEmailField": {
"type": "string"
},
"closed": {
"type": "boolean"
},
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"maxLength": {
"maximum": 3000,
"minimum": 1,
"type": "integer"
},
"name": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"options": {
"items": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
},
"required": {
"type": "boolean"
},
"type": {
"enum": [
"text",
"email",
"tel",
"number",
"date",
"textarea",
"select",
"checkbox",
"radio"
],
"type": "string"
}
},
"required": [
"name",
"label",
"type"
],
"type": "object"
},
"maxItems": 30,
"minItems": 1,
"type": "array"
},
"key": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"notifications": {
"enum": [
"enabled",
"disabled",
"unavailable"
],
"type": "string"
},
"notifyOwner": {
"type": "boolean"
},
"retentionDays": {
"type": "number"
},
"revision": {
"type": "number"
},
"state": {
"enum": [
"active",
"draft",
"closed",
"unavailable"
],
"type": "string"
},
"title": {
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"key",
"title",
"fields",
"revision",
"state",
"retentionDays",
"notifications"
],
"type": "object"
},
"type": "array"
},
"htmlContent": {
"description": "Current HTML content for the page",
"type": "string"
},
"imageLimits": {
"additionalProperties": false,
"description": "Hosted-image allowance for this website. Null counts mean no plan-specific cap. Existing images above a reduced limit can be kept or replaced, but the count cannot increase.",
"properties": {
"maxImages": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"remainingImages": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
]
},
"usedImages": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"maxImages",
"usedImages",
"remainingImages"
],
"type": "object"
},
"linkId": {
"description": "Carryo page link identifier",
"type": "string"
}
},
"required": [
"linkId",
"htmlContent"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"after": {
"type": "string"
},
"before": {
"type": "string"
},
"cursor": {
"maxLength": 100,
"type": "string"
},
"fields": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 30,
"type": "array"
},
"formKey": {
"maxLength": 64,
"type": "string"
},
"limit": {
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"linkId": {
"maxLength": 16,
"minLength": 16,
"type": "string"
},
"mode": {
"enum": [
"summary",
"responses"
],
"type": "string"
}
},
"required": [
"linkId"
],
"type": "object"
},
"name": "website.read_form_responses",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"forms": {
"items": {
"additionalProperties": false,
"properties": {
"acknowledgementEmailField": {
"type": "string"
},
"closed": {
"type": "boolean"
},
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"maxLength": {
"maximum": 3000,
"minimum": 1,
"type": "integer"
},
"name": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"options": {
"items": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
},
"required": {
"type": "boolean"
},
"type": {
"enum": [
"text",
"email",
"tel",
"number",
"date",
"textarea",
"select",
"checkbox",
"radio"
],
"type": "string"
}
},
"required": [
"name",
"label",
"type"
],
"type": "object"
},
"maxItems": 30,
"minItems": 1,
"type": "array"
},
"key": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"notifications": {
"enum": [
"enabled",
"disabled",
"unavailable"
],
"type": "string"
},
"notifyOwner": {
"type": "boolean"
},
"retentionDays": {
"type": "number"
},
"revision": {
"type": "number"
},
"state": {
"enum": [
"active",
"draft",
"closed",
"unavailable"
],
"type": "string"
},
"title": {
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"key",
"title",
"fields",
"revision",
"state",
"retentionDays",
"notifications"
],
"type": "object"
},
"type": "array"
},
"linkId": {
"type": "string"
},
"nextCursor": {
"type": "string"
},
"notificationCounts": {
"additionalProperties": false,
"description": "Email job counts; sent means accepted by the provider, not confirmed inbox delivery",
"properties": {
"failed": {
"type": "number"
},
"pending": {
"type": "number"
},
"sent": {
"type": "number"
},
"uncertain": {
"type": "number"
}
},
"required": [
"pending",
"sent",
"failed",
"uncertain"
],
"type": "object"
},
"responses": {
"items": {
"additionalProperties": false,
"properties": {
"createdAt": {
"type": "string"
},
"expiresAt": {
"type": "string"
},
"formKey": {
"type": "string"
},
"id": {
"type": "string"
},
"values": {
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
}
]
},
"type": "object"
}
},
"required": [
"id",
"formKey",
"createdAt",
"expiresAt",
"values"
],
"type": "object"
},
"type": "array"
},
"total": {
"type": "number"
},
"untrustedContent": {
"const": true,
"type": "boolean"
}
},
"required": [
"linkId",
"total",
"forms",
"untrustedContent"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"linkId": {
"description": "Carryo page link identifier to read",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"versionNumber": {
"description": "Specific page version number to read",
"exclusiveMinimum": 0,
"type": "integer"
}
},
"required": [
"linkId",
"versionNumber"
],
"type": "object"
},
"name": "website.read_version",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assets": {
"description": "Bundled asset descriptors",
"items": {
"additionalProperties": false,
"properties": {
"contentType": {
"description": "Asset MIME type",
"type": "string"
},
"path": {
"description": "Relative asset path in the page asset bundle",
"type": "string"
},
"sizeBytes": {
"description": "Asset size in bytes",
"type": "number"
}
},
"required": [
"path",
"contentType",
"sizeBytes"
],
"type": "object"
},
"type": "array"
},
"forms": {
"description": "Form definitions belonging to this historical version, for comparison or restoration; not its current collection state",
"items": {
"additionalProperties": false,
"properties": {
"acknowledgementEmailField": {
"type": "string"
},
"closed": {
"type": "boolean"
},
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"maxLength": {
"maximum": 3000,
"minimum": 1,
"type": "integer"
},
"name": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"options": {
"items": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
},
"required": {
"type": "boolean"
},
"type": {
"enum": [
"text",
"email",
"tel",
"number",
"date",
"textarea",
"select",
"checkbox",
"radio"
],
"type": "string"
}
},
"required": [
"name",
"label",
"type"
],
"type": "object"
},
"maxItems": 30,
"minItems": 1,
"type": "array"
},
"key": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"notifyOwner": {
"type": "boolean"
},
"title": {
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"key",
"title",
"fields"
],
"type": "object"
},
"type": "array"
},
"htmlContent": {
"description": "HTML content for the requested historical version",
"type": "string"
},
"linkId": {
"description": "Carryo page link identifier",
"type": "string"
},
"versionNumber": {
"description": "Page version number",
"type": "number"
}
},
"required": [
"linkId",
"versionNumber",
"htmlContent"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assets": {
"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.",
"items": {
"additionalProperties": false,
"properties": {
"contentType": {
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"fileId": {
"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.",
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"fileIndex": {
"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.",
"maximum": 19,
"minimum": 0,
"type": "integer"
},
"path": {
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"sourceUrl": {
"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.",
"maxLength": 4096,
"minLength": 1,
"type": "string"
}
},
"required": [
"path"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"customSlug": {
"description": "Optional user-chosen URL ending using lowercase letters, numbers, and hyphens. An automatic URL is generated when omitted.",
"maxLength": 64,
"minLength": 3,
"type": "string"
},
"expiresAt": {
"description": "Optional ISO-8601 expiration timestamp",
"type": "string"
},
"fileName": {
"description": "Short internal file name, for example client-proposal.html, board-deck.html, report.html, or landing-page.html.",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"forms": {
"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.",
"items": {
"additionalProperties": false,
"properties": {
"acknowledgementEmailField": {
"type": "string"
},
"closed": {
"type": "boolean"
},
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"maxLength": {
"maximum": 3000,
"minimum": 1,
"type": "integer"
},
"name": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"options": {
"items": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
},
"required": {
"type": "boolean"
},
"type": {
"enum": [
"text",
"email",
"tel",
"number",
"date",
"textarea",
"select",
"checkbox",
"radio"
],
"type": "string"
}
},
"required": [
"name",
"label",
"type"
],
"type": "object"
},
"maxItems": 30,
"minItems": 1,
"type": "array"
},
"key": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"notifyOwner": {
"type": "boolean"
},
"title": {
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"key",
"title",
"fields"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
},
"htmlContent": {
"description": "Complete HTML for the private Carryo draft page, presentation, slide deck, proposal, report, landing page, dashboard, invitation, portfolio, or one-page website.",
"maxLength": 5242880,
"minLength": 1,
"type": "string"
},
"imageFiles": {
"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.",
"items": {
"additionalProperties": false,
"properties": {
"download_url": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"file_id": {
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"file_name": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"mime_type": {
"maxLength": 255,
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"workspaceId": {
"description": "Optional exact workspaceId of the Carryo team explicitly selected by the user. The default destination is Personal when omitted.",
"pattern": "^ws_[A-Za-z0-9]+$",
"type": "string"
}
},
"required": [
"htmlContent",
"fileName"
],
"type": "object"
},
"name": "website.save_draft",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"currentVersionNumber": {
"type": "number"
},
"draftId": {
"description": "Carryo private draft identifier",
"type": "string"
},
"expiresAt": {
"$ref": "#/properties/workspaceId",
"description": "Optional ISO-8601 expiration timestamp"
},
"forms": {
"items": {
"additionalProperties": false,
"properties": {
"acknowledgementEmailField": {
"type": "string"
},
"closed": {
"type": "boolean"
},
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"maxLength": {
"maximum": 3000,
"minimum": 1,
"type": "integer"
},
"name": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"options": {
"items": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
},
"required": {
"type": "boolean"
},
"type": {
"enum": [
"text",
"email",
"tel",
"number",
"date",
"textarea",
"select",
"checkbox",
"radio"
],
"type": "string"
}
},
"required": [
"name",
"label",
"type"
],
"type": "object"
},
"maxItems": 30,
"minItems": 1,
"type": "array"
},
"key": {
"pattern": "^[a-z][a-z0-9_-]{0,63}$",
"type": "string"
},
"notifications": {
"enum": [
"enabled",
"disabled",
"unavailable"
],
"type": "string"
},
"notifyOwner": {
"type": "boolean"
},
"retentionDays": {
"type": "number"
},
"revision": {
"type": "number"
},
"state": {
"enum": [
"active",
"draft",
"closed",
"unavailable"
],
"type": "string"
},
"title": {
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"key",
"title",
"fields",
"revision",
"state",
"retentionDays",
"notifications"
],
"type": "object"
},
"type": "array"
},
"guidance": {
"additionalProperties": {},
"type": "object"
},
"manageUrl": {
"description": "Carryo URL where the user can review access settings and publish the draft",
"type": "string"
},
"message": {
"type": "string"
},
"publicationPerformed": {
"const": false,
"type": "boolean"
},
"status": {
"enum": [
"requires_adaptation",
"requires_entitlement",
"unsupported",
"unavailable"
],
"type": "string"
},
"workspaceId": {
"description": "Workspace that owns the draft; omitted for Personal",
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"linkId": {
"description": "Carryo page link identifier to take offline",
"maxLength": 255,
"minLength": 1,
"type": "string"
}
},
"required": [
"linkId"
],
"type": "object"
},
"name": "website.unpublish",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"deleteAt": {
"description": "ISO-8601 deletion timestamp",
"type": "string"
},
"linkId": {
"description": "Carryo page link identifier",
"type": "string"
},
"revokedAt": {
"description": "ISO-8601 revocation timestamp",
"type": "string"
}
},
"required": [
"linkId",
"revokedAt",
"deleteAt"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:addfc1e9aef555d3b4beeb95d9e6afdaa2a08594665f27ba520e441ee8dc446a | sha256sum