0.39.0npm · @kontent-ai/mcp-server · latest release
Observed 2026-08-31T06:42:16.058Z using mcpSecurity-inventory. Protocol 2025-06-18.
| Tool | Category | Risk |
|---|---|---|
bulk-get-content-item-variantsBulk/batch retrieve full details and content for multiple (2 or more) Kontent.ai content item variants by item and language reference pairs. Fetch full content for several items whose IDs were found via other tools.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"variants": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"item": {
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"description": "ID reference to a content item"
},
"language": {
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"description": "ID reference to a language"
}
},
"required": [
"item",
"language"
]
},
"description": "Array of item and language reference pairs to retrieve (max 100)."
},
"continuation_token": {
"description": "Continuation token from a previous response to fetch the next page of results. Omit this parameter (or set to null) to fetch the first page. The response will include a continuation_token field - use this value in the next request to fetch the next page. When continuation_token in the response is null, there are no more pages available.",
"type": "string"
}
},
"required": [
"variants"
]
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
cancel-scheduled-publishing-content-item-variantCancel scheduled publishing of Kontent.ai content item variant (language version/translation). Reverts variant back to previous workflow step, enabling further edits.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"itemId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Content item ID"
},
"languageId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Language ID (default: 00000000-0000-0000-0000-000000000000)"
}
},
"required": [
"itemId",
"languageId"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
change-content-item-variant-workflow-stepMove Kontent.ai content item variant (language version/translation) to a different workflow step. Transition content between lifecycle stages (e.g., draft to review, review to approved/published, or archive).Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"itemId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Content item ID"
},
"languageId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Language ID"
},
"workflowId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Workflow ID"
},
"workflowStepId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Target workflow step ID"
}
},
"required": [
"itemId",
"languageId",
"workflowId",
"workflowStepId"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
create-content-itemCreate (add) new Kontent.ai content item (creates the container only, use create-content-item-variant to add language versions/translations). Items are language-neutral and hold content item variants for each language.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Item name (1-200 chars)"
},
"type": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type this item is an instance of."
},
"codename": {
"description": "Codename (auto-generated if omitted)",
"type": "string"
},
"external_id": {
"description": "External ID",
"type": "string"
},
"collection": {
"description": "Reference to the collection this item belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"name",
"type"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
create-content-item-variantCreate Kontent.ai content item variant — translate and localize content into a specific language. Adds a new language version (translation) for a content item. Send only the elements you want to set (omitted ones initialize with default value). Element values must fulfill the content type definition.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"itemId": {
"type": "string",
"description": "Content item ID"
},
"languageId": {
"type": "string",
"description": "Language ID (default: 00000000-0000-0000-0000-000000000000)"
},
"elements": {
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
},
"description": "Element values to set"
},
"workflow_step_id": {
"description": "Workflow step ID",
"type": "string"
},
"note": {
"description": "Additional plain text only instructions or notes for content creators. Use line breaks/dashes for structure.",
"type": "string",
"maxLength": 4000
}
},
"required": [
"itemId",
"languageId",
"elements"
],
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"mode": {
"type": "string",
"enum": [
"autogenerated",
"custom"
],
"description": "REQUIRED on every URL slug element. 'autogenerated' (system-generated based on dependent text element) or 'custom' (manual). Switches to custom when value is directly modified."
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "URL-friendly slug value for SEO. Always send it together with 'mode' — a URL slug element sent without 'mode' is rejected by the Management API."
}
},
"required": [
"element",
"mode",
"value"
],
"description": "URL slug element - URL-friendly slug for SEO. Can be auto-generated from dependent text element or custom."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 100000
},
{
"type": "null"
}
],
"description": "Valid HTML5 fragment. Defaults to '<p><br/></p>' if empty."
},
"components": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier of the component within the rich text element."
},
"type": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type defining the component structure."
},
"elements": {
"anyOf": [
{
"type": "array",
"items": {
"description": "Element value within a component - same structure as top-level variant elements.",
"allOf": [
{
"$ref": "#/definitions/__schema0"
}
]
}
},
{
"type": "null"
}
],
"description": "Array of element values within the component (supports up to 6 levels deep nesting)."
}
},
"required": [
"id",
"type",
"elements"
],
"description": "Component embedded in rich text - a reusable content block defined by a content type."
}
},
{
"type": "null"
}
],
"description": "Array of nested component objects that can be embedded in the rich text content."
}
},
"required": [
"element",
"value",
"components"
],
"description": "Rich text element - formatted HTML content that can include embedded assets, components, content items, and links. Always submit the value together with the complete components array; on update, include components that should remain unchanged alongside any changes."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
{
"type": "null"
}
]
},
"display_timezone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "IANA time zone name affecting UI display without modifying stored value. Defaults to null (local time zone)."
}
},
"required": [
"element",
"value",
"display_timezone"
],
"description": "Date & time element - stores date and time values in UTC with optional display timezone."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 200000
},
{
"type": "null"
}
],
"description": "Custom-formatted data depending on the specific custom element implementation."
},
"searchable_value": {
"anyOf": [
{
"type": "string",
"maxLength": 200000
},
{
"type": "null"
}
],
"description": "Plain text for search functionality in content item lists."
}
},
"required": [
"element",
"value",
"searchable_value"
],
"description": "Custom element - stores custom-formatted data with optional searchable plain text representation."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Floating-point number."
}
},
"required": [
"element",
"value"
],
"description": "Number element - stores numeric floating-point values."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
{
"type": "null"
}
],
"description": "Array of Reference objects, each representing a single asset. Every asset can be referenced only once."
}
},
"required": [
"element",
"value"
],
"description": "Asset element - references to assets (images, documents). Supports renditions for image-specific editions."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
{
"type": "null"
}
],
"description": "Array of Reference objects. Each reference represents a single content item (each item referenced only once)."
}
},
"required": [
"element",
"value"
],
"description": "Linked items element - references to other content items for modular content."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
{
"type": "null"
}
],
"description": "Array of Reference objects. Each reference represents one of the multiple choice options defined in content type."
}
},
"required": [
"element",
"value"
],
"description": "Multiple choice element - references to selected choice options. Single-option mode requires exactly one reference."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
{
"type": "null"
}
],
"description": "Array of Reference objects. Each reference represents a taxonomy term (each term referenced only once)."
}
},
"required": [
"element",
"value"
],
"description": "Taxonomy element - references to taxonomy terms from a taxonomy group."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 100000
},
{
"type": "null"
}
],
"description": "Plain text content."
}
},
"required": [
"element",
"value"
],
"description": "Text element - stores plain text content."
}
]
}
}
}Annotations{
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
create-content-typeBuild a new Kontent.ai content type (schema/model) from scratch — define its elements, validation rules, and content groups. Use this to add a content type that does not yet exist.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Content type name"
},
"codename": {
"description": "Codename (auto-generated if omitted)",
"type": "string"
},
"external_id": {
"description": "External ID",
"type": "string"
},
"elements": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "asset"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"asset_count_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"maximum_file_size": {
"type": "number"
},
"allowed_file_types": {
"type": "string",
"enum": [
"adjustable",
"any"
]
},
"image_width_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"image_height_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "custom"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"source_url": {
"type": "string",
"format": "uri"
},
"json_parameters": {
"type": "string"
},
"allowed_elements": {
"description": "Array of references to other elements in this content type (or snippet) that this custom element is allowed to access.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name",
"source_url"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "date_time"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "guidelines"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"guidelines": {
"type": "string",
"description": "HTML content for guidelines element. Must be valid HTML."
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"guidelines"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "modular_content"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"allowed_content_types": {
"description": "Array of references to the content types allowed as linked items. Use an empty array to allow all content types.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"item_count_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "subpages"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"allowed_content_types": {
"description": "Array of references to the content types allowed as sub-pages. Use an empty array to allow all content types.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"item_count_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "multiple_choice"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"mode": {
"type": "string",
"enum": [
"single",
"multiple"
]
},
"options": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"required": [
"name"
]
}
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name",
"mode",
"options"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "number"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "number"
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "rich_text"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"allowed_blocks": {
"description": "Omit to allow all blocks. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"images",
"text",
"tables",
"components-and-items"
]
}
},
"allowed_formatting": {
"description": "Omit to allow all formatting options. If specified, 'unstyled' must be included. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"unstyled",
"bold",
"italic",
"code",
"link",
"subscript",
"superscript"
]
}
},
"allowed_text_blocks": {
"description": "Omit to allow all text blocks. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"paragraph",
"heading-one",
"heading-two",
"heading-three",
"heading-four",
"heading-five",
"heading-six",
"ordered-list",
"unordered-list"
]
}
},
"allowed_table_blocks": {
"description": "Omit to allow all blocks in tables. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"images",
"text"
]
}
},
"allowed_table_formatting": {
"description": "Omit to allow all table text formatting. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"unstyled",
"bold",
"italic",
"code",
"link",
"subscript",
"superscript"
]
}
},
"allowed_table_text_blocks": {
"description": "Omit to allow all text blocks in tables. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"paragraph",
"heading-one",
"heading-two",
"heading-three",
"heading-four",
"heading-five",
"heading-six",
"ordered-list",
"unordered-list"
]
}
},
"allowed_content_types": {
"description": "Array of references to the content types allowed as linked content items embedded in the rich text. Use an empty array to allow all content types.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"allowed_item_link_types": {
"description": "Array of references to the content types allowed as link targets within the rich text. Use an empty array to allow all content types.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"image_width_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"image_height_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"allowed_image_types": {
"type": "string",
"enum": [
"adjustable",
"any"
]
},
"maximum_image_size": {
"type": "number"
},
"maximum_text_length": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"applies_to": {
"type": "string",
"enum": [
"words",
"characters"
]
}
},
"required": [
"value",
"applies_to"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "snippet"
},
"snippet": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type snippet this element set is inherited from."
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"snippet"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "taxonomy"
},
"taxonomy_group": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the taxonomy group this element's terms are selected from."
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"term_count_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"taxonomy_group",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "text"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"maximum_text_length": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"applies_to": {
"type": "string",
"enum": [
"words",
"characters"
]
}
},
"required": [
"value",
"applies_to"
]
},
"validation_regex": {
"type": "object",
"properties": {
"is_active": {
"type": "boolean"
},
"regex": {
"type": "string"
},
"flags": {
"type": "string"
},
"validation_message": {
"type": "string"
}
},
"required": [
"is_active",
"regex"
]
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "url_slug"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"depends_on": {
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the text element this URL slug is generated from."
},
"snippet": {
"description": "Reference to the snippet containing the depended-on element, if it is defined in a snippet rather than directly on the content type.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"element"
]
},
"validation_regex": {
"type": "object",
"properties": {
"is_active": {
"type": "boolean"
},
"regex": {
"type": "string"
},
"flags": {
"type": "string"
},
"validation_message": {
"type": "string"
}
},
"required": [
"is_active",
"regex"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name",
"depends_on"
]
}
]
},
"description": "Elements defining structure"
},
"content_groups": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"external_id": {
"type": "string"
},
"codename": {
"type": "string"
}
},
"required": [
"name"
]
},
"description": "Content groups"
}
},
"required": [
"name",
"elements"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
create-content-type-snippetBuild (upsert) a new Kontent.ai content type snippet from scratch — a reusable set of elements you can include in multiple content types. Use this to add a snippet that does not yet exist.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Snippet name"
},
"codename": {
"description": "Codename (auto-generated if omitted)",
"type": "string"
},
"external_id": {
"description": "External ID",
"type": "string"
},
"elements": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "asset"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"asset_count_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"maximum_file_size": {
"type": "number"
},
"allowed_file_types": {
"type": "string",
"enum": [
"adjustable",
"any"
]
},
"image_width_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"image_height_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "custom"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"source_url": {
"type": "string",
"format": "uri"
},
"json_parameters": {
"type": "string"
},
"allowed_elements": {
"description": "Array of references to other elements in this content type (or snippet) that this custom element is allowed to access.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
}
},
"required": [
"type",
"name",
"source_url"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "date_time"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "guidelines"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"guidelines": {
"type": "string",
"description": "HTML content for guidelines element. Must be valid HTML."
}
},
"required": [
"type",
"guidelines"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "modular_content"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"allowed_content_types": {
"description": "Array of references to the content types allowed as linked items. Use an empty array to allow all content types.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"item_count_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "multiple_choice"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"mode": {
"type": "string",
"enum": [
"single",
"multiple"
]
},
"options": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"required": [
"name"
]
}
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
}
},
"required": [
"type",
"name",
"mode",
"options"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "number"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "number"
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "rich_text"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"allowed_blocks": {
"description": "Omit to allow all blocks. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"images",
"text",
"tables",
"components-and-items"
]
}
},
"allowed_formatting": {
"description": "Omit to allow all formatting options. If specified, 'unstyled' must be included. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"unstyled",
"bold",
"italic",
"code",
"link",
"subscript",
"superscript"
]
}
},
"allowed_text_blocks": {
"description": "Omit to allow all text blocks. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"paragraph",
"heading-one",
"heading-two",
"heading-three",
"heading-four",
"heading-five",
"heading-six",
"ordered-list",
"unordered-list"
]
}
},
"allowed_table_blocks": {
"description": "Omit to allow all blocks in tables. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"images",
"text"
]
}
},
"allowed_table_formatting": {
"description": "Omit to allow all table text formatting. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"unstyled",
"bold",
"italic",
"code",
"link",
"subscript",
"superscript"
]
}
},
"allowed_table_text_blocks": {
"description": "Omit to allow all text blocks in tables. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"paragraph",
"heading-one",
"heading-two",
"heading-three",
"heading-four",
"heading-five",
"heading-six",
"ordered-list",
"unordered-list"
]
}
},
"allowed_content_types": {
"description": "Array of references to the content types allowed as linked content items embedded in the rich text. Use an empty array to allow all content types.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"allowed_item_link_types": {
"description": "Array of references to the content types allowed as link targets within the rich text. Use an empty array to allow all content types.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"image_width_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"image_height_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"allowed_image_types": {
"type": "string",
"enum": [
"adjustable",
"any"
]
},
"maximum_image_size": {
"type": "number"
},
"maximum_text_length": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"applies_to": {
"type": "string",
"enum": [
"words",
"characters"
]
}
},
"required": [
"value",
"applies_to"
]
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "taxonomy"
},
"taxonomy_group": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the taxonomy group this element's terms are selected from."
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"term_count_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
}
},
"required": [
"type",
"taxonomy_group",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "text"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"maximum_text_length": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"applies_to": {
"type": "string",
"enum": [
"words",
"characters"
]
}
},
"required": [
"value",
"applies_to"
]
},
"validation_regex": {
"type": "object",
"properties": {
"is_active": {
"type": "boolean"
},
"regex": {
"type": "string"
},
"flags": {
"type": "string"
},
"validation_message": {
"type": "string"
}
},
"required": [
"is_active",
"regex"
]
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
}
},
"required": [
"type",
"name"
]
}
]
},
"description": "Elements defining structure"
}
},
"required": [
"name",
"elements"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
create-languageCreate (add) and configure new Kontent.ai language locale for translations and localization. Languages are always created as active.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Display name of the language"
},
"codename": {
"type": "string",
"description": "Codename identifier for the language"
},
"fallback_language": {
"description": "Reference to the fallback language.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"external_id": {
"description": "External ID for the language",
"type": "string"
}
},
"required": [
"name",
"codename"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
create-new-content-item-variant-versionCreate new draft version of a published Kontent.ai content item variant (language version/translation). Required before editing published content.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"itemId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Content item ID"
},
"languageId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Language ID (default: 00000000-0000-0000-0000-000000000000)"
}
},
"required": [
"itemId",
"languageId"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
create-spaceCreate (add) new Kontent.ai space for managing a website or channel. Spaces provide channel-specific context with their own domain and preview URLs.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"name": {
"type": "string"
},
"codename": {
"type": "string"
},
"collections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the collections this space includes."
}
},
"required": [
"name"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
create-taxonomy-groupCreate (add) new Kontent.ai taxonomy group for content categorization. Taxonomy groups contain hierarchical terms (categories/tags) for classifying content.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Taxonomy group name"
},
"codename": {
"description": "Codename (auto-generated if omitted)",
"type": "string"
},
"external_id": {
"description": "External ID",
"type": "string"
},
"terms": {
"description": "Taxonomy terms hierarchy",
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
}
},
"required": [
"name"
],
"definitions": {
"__schema0": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"terms": {
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
}
},
"required": [
"name"
]
}
}
}Annotations{
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
create-workflowCreate (add) new Kontent.ai workflow with custom steps. Workflows define content lifecycle stages for review and approval.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Human-readable name of the workflow"
},
"codename": {
"description": "Codename for API operations (auto-generated if omitted)",
"type": "string"
},
"scopes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"content_types": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Content types this workflow applies to"
},
"collections": {
"description": "Collections this workflow applies to",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
}
},
"required": [
"content_types"
]
},
"description": "Array of scopes defining which combinations of content types and collections this workflow applies to. If both content types and collections are empty, the workflow can be used for any type of content in collection that isn't limited to any other workflow."
},
"steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Human-readable name of the workflow step"
},
"codename": {
"type": "string",
"description": "Codename of the workflow step. Must be unique across all workflows - usually prepended with the workflow codename."
},
"id": {
"readOnly": true,
"description": "Read-only workflow step ID (useful to reference a step when updating its codename)",
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"color": {
"type": "string",
"enum": [
"gray",
"red",
"rose",
"light-purple",
"dark-purple",
"dark-blue",
"light-blue",
"sky-blue",
"mint-green",
"persian-green",
"dark-green",
"light-green",
"yellow",
"pink",
"orange",
"brown"
],
"description": "Color of the workflow step displayed in the UI"
},
"transitions_to": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"step": {
"type": "object",
"properties": {
"codename": {
"description": "Target step codename",
"type": "string"
},
"id": {
"description": "Target step ID (for update operations)",
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
},
"description": "Reference to the target step"
}
},
"required": [
"step"
]
},
"description": "Array of step references this step can transition to. Every custom step must eventually be able to reach the built-in 'published' step, whether directly or via a chain through other custom steps (reference the published step as {\"step\":{\"codename\":\"published\"}}) - a step with no path to Published makes the workflow invalid."
},
"role_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"description": "Array of role IDs that have permissions for this step. Leave empty to allow all roles."
}
},
"required": [
"name",
"codename",
"color",
"transitions_to",
"role_ids"
]
},
"description": "Array of custom workflow steps. Every step's transitions_to must form a path that eventually reaches the built-in 'published' step (directly or through other custom steps) - a step with no route to Published makes the whole workflow invalid."
},
"published_step": {
"type": "object",
"properties": {
"unpublish_role_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"description": "Array of role IDs that can unpublish content. Leave empty to allow all roles."
},
"create_new_version_role_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"description": "Array of role IDs that can create new versions. Leave empty to allow all roles."
}
},
"required": [
"unpublish_role_ids",
"create_new_version_role_ids"
],
"description": "Configuration for the published step"
},
"archived_step": {
"type": "object",
"properties": {
"role_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"description": "Array of role IDs that can restore archived content. Leave empty to allow all roles."
}
},
"required": [
"role_ids"
],
"description": "Configuration for the archived step"
}
},
"required": [
"name",
"scopes",
"steps",
"published_step",
"archived_step"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
delete-content-itemDelete (remove) Kontent.ai content item and all its content item variants.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Content item ID"
}
},
"required": [
"id"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
delete-content-item-variantDelete (remove) Kontent.ai content item variant (language version/translation). Removes translated content for a specific language from an item.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"itemId": {
"type": "string",
"description": "Content item ID"
},
"languageId": {
"type": "string",
"description": "Language ID"
}
},
"required": [
"itemId",
"languageId"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
delete-content-typeDelete (remove) Kontent.ai content type by ID. Removes the schema/model definition.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Content type ID"
}
},
"required": [
"id"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
delete-content-type-snippetDelete (remove) Kontent.ai content type snippet by ID. Removes the reusable shared element set definition.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Content type snippet ID"
}
},
"required": [
"id"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
delete-spaceDelete (remove) Kontent.ai space by ID. Removes the channel/website context.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Space ID"
}
},
"required": [
"id"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
delete-taxonomy-groupDelete (remove) Kontent.ai taxonomy group by ID. Removes the category/tag group and all its terms.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Taxonomy group ID"
}
},
"required": [
"id"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
delete-workflowDelete (remove) Kontent.ai workflow. Cannot delete the default workflow.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Workflow ID"
}
},
"required": [
"id"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
get-assetRetrieve Kontent.ai asset by ID. Assets are digital media files (images, videos, documents, PDFs) standalone, or referenced from other entities, typically content item variants.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"assetId": {
"type": "string",
"description": "Asset ID"
}
},
"required": [
"assetId"
]
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
get-content-itemRetrieve (fetch) a single Kontent.ai content item by ID — returns its details: name, codename, and content type. Items are language-neutral containers; one item has multiple content item variants (translations). Do NOT call this in a loop to identify an item among several candidates by name — narrow down first with list-content-item-variants's search_phrase filter.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Content item ID"
}
},
"required": [
"id"
]
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
get-content-item-translationsGet all Kontent.ai content item translations — every language version (variant) of a specific content item. Returns each language's current version (draft if one exists, otherwise the last one saved), which may differ from the version currently live on the Delivery API. Retrieve translated content across all languages to examine details of a specific item in translation scenarios, rather than to search for items — for finding or disambiguating among candidates, use list-content-item-variants's search_phrase filter.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"itemId": {
"type": "string",
"description": "Content item ID"
}
},
"required": [
"itemId"
]
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
get-content-item-variantRetrieve a single Kontent.ai content item variant (language version/translation) by item and language ID. Returns the current version — draft if one exists, otherwise published.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"itemId": {
"type": "string",
"description": "Content item ID"
},
"languageId": {
"type": "string",
"description": "Language ID"
}
},
"required": [
"itemId",
"languageId"
]
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
get-content-typeRetrieve (fetch) a single Kontent.ai content type by ID — its schema/model definition. Content types define content structure: elements, field validation rules, and content groups.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Content type ID"
}
},
"required": [
"id"
]
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
get-content-type-snippetRetrieve Kontent.ai content type snippet. Snippets are reusable, shared sets of elements included across multiple content types.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Content type snippet ID"
}
},
"required": [
"id"
]
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
get-patch-guideREQUIRED before any patch operation. Returns operation constraints and caveats not visible in the patch tool schemas — including unsupported operations, conditions under which operations fail, and ordering rules. Call this before constructing any patch.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"entityType": {
"type": "string",
"enum": [
"content-type",
"snippet",
"taxonomy",
"collection",
"asset-folder",
"space",
"language"
],
"description": "Entity type to get patch guide for: content-type, snippet, taxonomy, collection, asset-folder, space, language"
}
},
"required": [
"entityType"
]
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
get-published-content-item-variant-versionRetrieve the published (live) version and details of a Kontent.ai content item variant, exactly as served on the Delivery API right now, even when a newer draft version exists.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"itemId": {
"type": "string",
"description": "Content item ID"
},
"languageId": {
"type": "string",
"description": "Language ID"
}
},
"required": [
"itemId",
"languageId"
]
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
get-taxonomy-groupRetrieve Kontent.ai taxonomy group by ID or codename. Taxonomy groups provide a classification hierarchy of tree-structured terms (categories/tags) that can be nested to any depth for content categorization.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Taxonomy group ID"
}
},
"required": [
"id"
]
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
list-asset-foldersList all Kontent.ai asset folders. Folders organize digital media files (images, videos, documents) into a hierarchical directory structure.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {}
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
list-assetsList all Kontent.ai assets (paginated). Assets are digital media files (images, videos, documents, PDFs) referenced in content items.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"continuation_token": {
"description": "Continuation token from a previous response to fetch the next page of results. Omit this parameter (or set to null) to fetch the first page. The response will include a continuation_token field - use this value in the next request to fetch the next page. When continuation_token in the response is null, there are no more pages available.",
"type": "string"
}
}
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
list-collectionsList all Kontent.ai collections. Collections organize and group content items by team, brand, or project for access control and content separation.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {}
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
list-content-item-variantsList, find, filter Kontent.ai content items with content item variants (language versions/translations), returning lightweight item ID + language ID references for further lookup. Filter by content item content type, collection, space, workflow step, taxonomy, contained content component content type, or publishing state. Search items and variants by EXACT keyword matching (terms use OR). Use search-content-item-variants when you know what content is *about* (topic, theme) rather than its name or identity.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"search_phrase": {
"description": "Specific phrase or keywords to look for in content",
"type": "string"
},
"content_types": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
]
},
"description": "Array of ID references to content types."
},
"contributors": {
"minItems": 1,
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "User identifier"
},
"email": {
"not": {}
}
},
"required": [
"id"
]
},
{
"type": "object",
"properties": {
"id": {
"not": {}
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "User email address"
}
},
"required": [
"email"
]
}
],
"description": "Reference to a user by either their id or email (but not both)"
},
"description": "Array of references to users by their id or email (but not both per user)"
},
"has_no_contributors": {
"description": "Filter for content item variants that have no contributors assigned",
"type": "boolean"
},
"completion_statuses": {
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"enum": [
"unfinished",
"ready",
"not_translated",
"all_done"
]
},
"description": "Array of completion statuses to filter by. It is not the same thing as workflow steps, it reflects e.g. not filled in required elements"
},
"language": {
"description": "ID reference to a language (defaults to default language).",
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
]
},
"workflow_steps": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"workflow_identifier": {
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"description": "ID reference to a workflow."
},
"step_identifiers": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
]
},
"description": "Array of ID references to workflow steps (from the same workflow's steps, as returned by list-workflows)."
}
},
"required": [
"workflow_identifier",
"step_identifiers"
]
},
"description": "Array of workflows with workflow steps"
},
"taxonomy_groups": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"taxonomy_identifier": {
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"description": "ID reference to a taxonomy group."
},
"term_identifiers": {
"description": "Array of ID references to taxonomy terms (from the same taxonomy group, as returned by list-taxonomy-groups).",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
]
}
},
"include_uncategorized": {
"description": "Whether to include content item variants that don't have any taxonomy terms assigned in this taxonomy group",
"type": "boolean"
}
},
"required": [
"taxonomy_identifier"
]
},
"description": "Array of taxonomy groups with taxonomy terms"
},
"spaces": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
]
},
"description": "Array of ID references to spaces."
},
"collections": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
]
},
"description": "Array of ID references to collections."
},
"component_types": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
]
},
"description": "Array of ID references to content component types stored in variants."
},
"publishing_states": {
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"enum": [
"published",
"unpublished",
"not_published_yet"
]
},
"description": "Array of publishing states to filter by. 'published' - variant is currently published, 'unpublished' - variant was published but is now unpublished, 'not_published_yet' - variant has never been published"
},
"order_by": {
"description": "Field to order by",
"type": "string",
"enum": [
"name",
"due_date",
"last_modified"
]
},
"order_direction": {
"description": "Order direction",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"continuation_token": {
"description": "Continuation token from a previous response to fetch the next page of results. Omit this parameter (or set to null) to fetch the first page. The response will include a continuation_token field - use this value in the next request to fetch the next page. When continuation_token in the response is null, there are no more pages available.",
"type": "string"
}
}
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
list-content-type-snippetsList all Kontent.ai content type snippets (paginated). Retrieve every content type snippet — reusable, shared sets of elements included across multiple content types.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"continuation_token": {
"description": "Continuation token from a previous response to fetch the next page of results. Omit this parameter (or set to null) to fetch the first page. The response will include a continuation_token field - use this value in the next request to fetch the next page. When continuation_token in the response is null, there are no more pages available.",
"type": "string"
}
}
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
list-content-typesList all Kontent.ai content types (paginated). Retrieve every content type (schema/model) definition. Get an overview of all content type models, their elements, field validation rules, and content groups.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"continuation_token": {
"description": "Continuation token from a previous response to fetch the next page of results. Omit this parameter (or set to null) to fetch the first page. The response will include a continuation_token field - use this value in the next request to fetch the next page. When continuation_token in the response is null, there are no more pages available.",
"type": "string"
}
}
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
list-languagesList all Kontent.ai languages (paginated), including inactive ones - check is_active property. Languages define available locales for translations and localization; each can have fallback language for content inheritance.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"continuation_token": {
"description": "Continuation token from a previous response to fetch the next page of results. Omit this parameter (or set to null) to fetch the first page. The response will include a continuation_token field - use this value in the next request to fetch the next page. When continuation_token in the response is null, there are no more pages available.",
"type": "string"
}
}
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
list-rolesList all Kontent.ai roles. Roles define user permissions and access control within the environment.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {}
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
list-spacesList all Kontent.ai spaces. Spaces provide channel-specific site configuration for managing multiple websites/channels. Each space has its own domain and preview URLs; collections connect to spaces to organize content per channel.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {}
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
list-taxonomy-groupsList all Kontent.ai taxonomy groups (paginated). Taxonomy groups contain hierarchical tree-structured terms (categories/tags) that can be nested to any depth for content categorization and classification.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"continuation_token": {
"description": "Continuation token from a previous response to fetch the next page of results. Omit this parameter (or set to null) to fetch the first page. The response will include a continuation_token field - use this value in the next request to fetch the next page. When continuation_token in the response is null, there are no more pages available.",
"type": "string"
}
}
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
list-workflowsList all Kontent.ai workflows and their steps. Workflows define content lifecycle stages: draft, review, approval, published, scheduled, archived.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {}
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
patch-asset-foldersUpdate (modify/edit) Kontent.ai asset folders using patch operations. Always call get-patch-guide(entityType='asset-folder') first — it documents constraints not visible in this schema that the API enforces.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"patchGuideId": {
"type": "string",
"description": "The patchGuideId value returned by the get-patch-guide(entityType='asset-folder') tool result in this conversation. Call get-patch-guide(entityType='asset-folder') first if you have not done so, then copy the patchGuideId it returned here — this confirms you received and read the patch guide before constructing operations."
},
"operations": {
"minItems": 1,
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "addInto"
},
"reference": {
"description": "Parent folder reference. Omit to add at root level.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"value": {
"$ref": "#/definitions/__schema0"
},
"before": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the sibling folder to insert before."
}
},
"required": [
"op",
"value",
"before"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "addInto"
},
"reference": {
"description": "Parent folder reference. Omit to add at root level.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"value": {
"$ref": "#/definitions/__schema0"
},
"after": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the sibling folder to insert after."
}
},
"required": [
"op",
"value",
"after"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "addInto"
},
"reference": {
"description": "Parent folder reference. Omit to add at root level.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"value": {
"$ref": "#/definitions/__schema0"
}
},
"required": [
"op",
"value"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "rename"
},
"reference": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the folder to rename."
},
"value": {
"type": "string"
}
},
"required": [
"op",
"reference",
"value"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "remove"
},
"reference": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the folder to remove."
}
},
"required": [
"op",
"reference"
]
}
]
},
"description": "Patch operations array. Use addInto to add new folders (with optional reference for parent, before/after for positioning), rename to change folder names, remove to delete folders."
}
},
"required": [
"patchGuideId",
"operations"
],
"definitions": {
"__schema0": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"folders": {
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
}
},
"required": [
"name"
]
}
}
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
patch-collectionsUpdate (modify/edit) Kontent.ai collections using patch operations. Always call get-patch-guide(entityType='collection') first — it documents constraints not visible in this schema that the API enforces.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"patchGuideId": {
"type": "string",
"description": "The patchGuideId value returned by the get-patch-guide(entityType='collection') tool result in this conversation. Call get-patch-guide(entityType='collection') first if you have not done so, then copy the patchGuideId it returned here — this confirms you received and read the patch guide before constructing operations."
},
"operations": {
"minItems": 1,
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "addInto"
},
"value": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"required": [
"name"
]
},
"before": {
"description": "Reference to the sibling collection to insert before.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"after": {
"description": "Reference to the sibling collection to insert after.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"op",
"value"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "move"
},
"reference": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the collection to move."
},
"before": {
"description": "Reference to the sibling collection to move before.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"after": {
"description": "Reference to the sibling collection to move after.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"op",
"reference"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "remove"
},
"reference": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the collection to remove."
}
},
"required": [
"op",
"reference"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "replace"
},
"reference": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the collection to update."
},
"property_name": {
"type": "string",
"enum": [
"name"
]
},
"value": {
"type": "string"
}
},
"required": [
"op",
"reference",
"property_name",
"value"
]
}
]
},
"description": "Patch operations array. Call list-collections first. Use addInto to add new collections, move to reorder, remove to delete empty collections, replace to rename."
}
},
"required": [
"patchGuideId",
"operations"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
patch-content-typeUpdate (modify/edit) Kontent.ai content type schema using patch operations (add, move, remove, replace elements/fields). Add new fields, rearrange or remove existing elements. Always call get-patch-guide(entityType='content-type') first for operations reference.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"patchGuideId": {
"type": "string",
"description": "The patchGuideId value returned by the get-patch-guide(entityType='content-type') tool result in this conversation. Call get-patch-guide(entityType='content-type') first if you have not done so, then copy the patchGuideId it returned here — this confirms you received and read the patch guide before constructing operations."
},
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Content type ID"
},
"operations": {
"minItems": 1,
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "move"
},
"path": {
"type": "string",
"description": "Path to object (format: id:{uuid})"
},
"before": {
"description": "Reference to the sibling element, option, or content group (matching the item at path) to position before.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"after": {
"description": "Reference to the sibling element, option, or content group (matching the item at path) to position after.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"op",
"path"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "addInto"
},
"path": {
"type": "string",
"description": "Path where to add item (format: id:{uuid})"
},
"value": {
"anyOf": [
{
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "asset"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"asset_count_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"maximum_file_size": {
"type": "number"
},
"allowed_file_types": {
"type": "string",
"enum": [
"adjustable",
"any"
]
},
"image_width_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"image_height_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "custom"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"source_url": {
"type": "string",
"format": "uri"
},
"json_parameters": {
"type": "string"
},
"allowed_elements": {
"description": "Array of references to other elements in this content type (or snippet) that this custom element is allowed to access.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name",
"source_url"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "date_time"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "guidelines"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"guidelines": {
"type": "string",
"description": "HTML content for guidelines element. Must be valid HTML."
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"guidelines"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "modular_content"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"allowed_content_types": {
"description": "Array of references to the content types allowed as linked items. Use an empty array to allow all content types.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"item_count_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "subpages"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"allowed_content_types": {
"description": "Array of references to the content types allowed as sub-pages. Use an empty array to allow all content types.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"item_count_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "multiple_choice"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"mode": {
"type": "string",
"enum": [
"single",
"multiple"
]
},
"options": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"required": [
"name"
]
}
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name",
"mode",
"options"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "number"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "number"
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "rich_text"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"allowed_blocks": {
"description": "Omit to allow all blocks. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"images",
"text",
"tables",
"components-and-items"
]
}
},
"allowed_formatting": {
"description": "Omit to allow all formatting options. If specified, 'unstyled' must be included. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"unstyled",
"bold",
"italic",
"code",
"link",
"subscript",
"superscript"
]
}
},
"allowed_text_blocks": {
"description": "Omit to allow all text blocks. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"paragraph",
"heading-one",
"heading-two",
"heading-three",
"heading-four",
"heading-five",
"heading-six",
"ordered-list",
"unordered-list"
]
}
},
"allowed_table_blocks": {
"description": "Omit to allow all blocks in tables. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"images",
"text"
]
}
},
"allowed_table_formatting": {
"description": "Omit to allow all table text formatting. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"unstyled",
"bold",
"italic",
"code",
"link",
"subscript",
"superscript"
]
}
},
"allowed_table_text_blocks": {
"description": "Omit to allow all text blocks in tables. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"paragraph",
"heading-one",
"heading-two",
"heading-three",
"heading-four",
"heading-five",
"heading-six",
"ordered-list",
"unordered-list"
]
}
},
"allowed_content_types": {
"description": "Array of references to the content types allowed as linked content items embedded in the rich text. Use an empty array to allow all content types.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"allowed_item_link_types": {
"description": "Array of references to the content types allowed as link targets within the rich text. Use an empty array to allow all content types.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"image_width_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"image_height_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"allowed_image_types": {
"type": "string",
"enum": [
"adjustable",
"any"
]
},
"maximum_image_size": {
"type": "number"
},
"maximum_text_length": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"applies_to": {
"type": "string",
"enum": [
"words",
"characters"
]
}
},
"required": [
"value",
"applies_to"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "snippet"
},
"snippet": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type snippet this element set is inherited from."
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"snippet"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "taxonomy"
},
"taxonomy_group": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the taxonomy group this element's terms are selected from."
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"term_count_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"taxonomy_group",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "text"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"maximum_text_length": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"applies_to": {
"type": "string",
"enum": [
"words",
"characters"
]
}
},
"required": [
"value",
"applies_to"
]
},
"validation_regex": {
"type": "object",
"properties": {
"is_active": {
"type": "boolean"
},
"regex": {
"type": "string"
},
"flags": {
"type": "string"
},
"validation_message": {
"type": "string"
}
},
"required": [
"is_active",
"regex"
]
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "url_slug"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"depends_on": {
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the text element this URL slug is generated from."
},
"snippet": {
"description": "Reference to the snippet containing the depended-on element, if it is defined in a snippet rather than directly on the content type.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"element"
]
},
"validation_regex": {
"type": "object",
"properties": {
"is_active": {
"type": "boolean"
},
"regex": {
"type": "string"
},
"flags": {
"type": "string"
},
"validation_message": {
"type": "string"
}
},
"required": [
"is_active",
"regex"
]
},
"content_group": {
"description": "Reference to the content group this element belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"type",
"name",
"depends_on"
]
}
]
},
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"external_id": {
"type": "string"
},
"codename": {
"type": "string"
}
},
"required": [
"name"
]
},
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"required": [
"name"
]
},
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
{
"type": "string",
"enum": [
"images",
"text",
"tables",
"components-and-items"
]
},
{
"type": "string",
"enum": [
"unstyled",
"bold",
"italic",
"code",
"link",
"subscript",
"superscript"
]
},
{
"type": "string",
"enum": [
"paragraph",
"heading-one",
"heading-two",
"heading-three",
"heading-four",
"heading-five",
"heading-six",
"ordered-list",
"unordered-list"
]
},
{
"type": "string",
"enum": [
"images",
"text"
]
},
{
"type": "string",
"enum": [
"unstyled",
"bold",
"italic",
"code",
"link",
"subscript",
"superscript"
]
},
{
"type": "string",
"enum": [
"paragraph",
"heading-one",
"heading-two",
"heading-three",
"heading-four",
"heading-five",
"heading-six",
"ordered-list",
"unordered-list"
]
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{}
]
}
},
"required": [
"op",
"path",
"value"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "remove"
},
"path": {
"type": "string",
"description": "Path to item to remove (format: id:{uuid})"
}
},
"required": [
"op",
"path"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "replace"
},
"path": {
"type": "string",
"description": "Path to property to replace (format: id:{uuid})"
},
"value": {
"anyOf": [
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the text element this URL slug is generated from."
},
"snippet": {
"description": "Reference to the snippet containing the depended-on element, if it is defined in a snippet rather than directly on the content type.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"element"
]
},
{
"type": "object",
"properties": {
"is_active": {
"type": "boolean"
},
"regex": {
"type": "string"
},
"flags": {
"type": "string"
},
"validation_message": {
"type": "string"
}
},
"required": [
"is_active",
"regex"
]
},
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"applies_to": {
"type": "string",
"enum": [
"words",
"characters"
]
}
},
"required": [
"value",
"applies_to"
]
},
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
{
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
{
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
{
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "number"
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{}
]
}
},
"required": [
"op",
"path"
]
}
]
},
"description": "Patch operations array. CRITICAL: Always call get-content-type first.\n- Use addInto/remove for arrays, replace for primitives/objects\n- Only one url_slug element allowed per content type\n- To remove content groups: set ALL elements' content_group to null AND remove ALL groups in one request\n- URL slug with snippet: add snippet element first, then url_slug with depends_on reference\n- To move an element to a different content_group, combine two ops in one patch: replace its content_group, then move it to the desired position"
}
},
"required": [
"patchGuideId",
"id",
"operations"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
patch-content-type-snippetUpdate (modify/edit) Kontent.ai content type snippet using patch operations (add, move, remove, replace elements/fields). Add new fields to an existing snippet, or rearrange or remove existing elements. Always call get-patch-guide(entityType='snippet') first for operations reference.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"patchGuideId": {
"type": "string",
"description": "The patchGuideId value returned by the get-patch-guide(entityType='snippet') tool result in this conversation. Call get-patch-guide(entityType='snippet') first if you have not done so, then copy the patchGuideId it returned here — this confirms you received and read the patch guide before constructing operations."
},
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Content type snippet ID"
},
"operations": {
"minItems": 1,
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "move"
},
"path": {
"type": "string",
"description": "Path to object (format: id:{uuid})"
},
"before": {
"description": "Reference to the sibling element, option, or content group (matching the item at path) to position before.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"after": {
"description": "Reference to the sibling element, option, or content group (matching the item at path) to position after.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"op",
"path"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "addInto"
},
"path": {
"type": "string",
"description": "Path where to add item (format: id:{uuid})"
},
"value": {
"anyOf": [
{
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "asset"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"asset_count_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"maximum_file_size": {
"type": "number"
},
"allowed_file_types": {
"type": "string",
"enum": [
"adjustable",
"any"
]
},
"image_width_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"image_height_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "custom"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"source_url": {
"type": "string",
"format": "uri"
},
"json_parameters": {
"type": "string"
},
"allowed_elements": {
"description": "Array of references to other elements in this content type (or snippet) that this custom element is allowed to access.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
}
},
"required": [
"type",
"name",
"source_url"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "date_time"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "guidelines"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"guidelines": {
"type": "string",
"description": "HTML content for guidelines element. Must be valid HTML."
}
},
"required": [
"type",
"guidelines"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "modular_content"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"allowed_content_types": {
"description": "Array of references to the content types allowed as linked items. Use an empty array to allow all content types.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"item_count_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "multiple_choice"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"mode": {
"type": "string",
"enum": [
"single",
"multiple"
]
},
"options": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"required": [
"name"
]
}
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
}
},
"required": [
"type",
"name",
"mode",
"options"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "number"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "number"
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "rich_text"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"allowed_blocks": {
"description": "Omit to allow all blocks. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"images",
"text",
"tables",
"components-and-items"
]
}
},
"allowed_formatting": {
"description": "Omit to allow all formatting options. If specified, 'unstyled' must be included. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"unstyled",
"bold",
"italic",
"code",
"link",
"subscript",
"superscript"
]
}
},
"allowed_text_blocks": {
"description": "Omit to allow all text blocks. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"paragraph",
"heading-one",
"heading-two",
"heading-three",
"heading-four",
"heading-five",
"heading-six",
"ordered-list",
"unordered-list"
]
}
},
"allowed_table_blocks": {
"description": "Omit to allow all blocks in tables. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"images",
"text"
]
}
},
"allowed_table_formatting": {
"description": "Omit to allow all table text formatting. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"unstyled",
"bold",
"italic",
"code",
"link",
"subscript",
"superscript"
]
}
},
"allowed_table_text_blocks": {
"description": "Omit to allow all text blocks in tables. Do not list every possible value explicitly - that is rejected as redundant; use an empty array or omit the property instead.",
"type": "array",
"items": {
"type": "string",
"enum": [
"paragraph",
"heading-one",
"heading-two",
"heading-three",
"heading-four",
"heading-five",
"heading-six",
"ordered-list",
"unordered-list"
]
}
},
"allowed_content_types": {
"description": "Array of references to the content types allowed as linked content items embedded in the rich text. Use an empty array to allow all content types.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"allowed_item_link_types": {
"description": "Array of references to the content types allowed as link targets within the rich text. Use an empty array to allow all content types.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"image_width_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"image_height_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"allowed_image_types": {
"type": "string",
"enum": [
"adjustable",
"any"
]
},
"maximum_image_size": {
"type": "number"
},
"maximum_text_length": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"applies_to": {
"type": "string",
"enum": [
"words",
"characters"
]
}
},
"required": [
"value",
"applies_to"
]
}
},
"required": [
"type",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "taxonomy"
},
"taxonomy_group": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the taxonomy group this element's terms are selected from."
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"term_count_limit": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
}
},
"required": [
"type",
"taxonomy_group",
"name"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "text"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"name": {
"type": "string"
},
"guidelines": {
"description": "Plain text guidelines shown to editors",
"type": "string"
},
"is_required": {
"type": "boolean"
},
"is_non_localizable": {
"type": "boolean"
},
"maximum_text_length": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"applies_to": {
"type": "string",
"enum": [
"words",
"characters"
]
}
},
"required": [
"value",
"applies_to"
]
},
"validation_regex": {
"type": "object",
"properties": {
"is_active": {
"type": "boolean"
},
"regex": {
"type": "string"
},
"flags": {
"type": "string"
},
"validation_message": {
"type": "string"
}
},
"required": [
"is_active",
"regex"
]
},
"default": {
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
}
},
"required": [
"type",
"name"
]
}
]
},
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"required": [
"name"
]
},
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
{
"type": "string",
"enum": [
"images",
"text",
"tables",
"components-and-items"
]
},
{
"type": "string",
"enum": [
"unstyled",
"bold",
"italic",
"code",
"link",
"subscript",
"superscript"
]
},
{
"type": "string",
"enum": [
"paragraph",
"heading-one",
"heading-two",
"heading-three",
"heading-four",
"heading-five",
"heading-six",
"ordered-list",
"unordered-list"
]
},
{
"type": "string",
"enum": [
"images",
"text"
]
},
{
"type": "string",
"enum": [
"unstyled",
"bold",
"italic",
"code",
"link",
"subscript",
"superscript"
]
},
{
"type": "string",
"enum": [
"paragraph",
"heading-one",
"heading-two",
"heading-three",
"heading-four",
"heading-five",
"heading-six",
"ordered-list",
"unordered-list"
]
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{}
]
}
},
"required": [
"op",
"path",
"value"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "remove"
},
"path": {
"type": "string",
"description": "Path to item to remove (format: id:{uuid})"
}
},
"required": [
"op",
"path"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "replace"
},
"path": {
"type": "string",
"description": "Path to property to replace (format: id:{uuid})"
},
"value": {
"anyOf": [
{
"type": "object",
"properties": {
"is_active": {
"type": "boolean"
},
"regex": {
"type": "string"
},
"flags": {
"type": "string"
},
"validation_message": {
"type": "string"
}
},
"required": [
"is_active",
"regex"
]
},
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"applies_to": {
"type": "string",
"enum": [
"words",
"characters"
]
}
},
"required": [
"value",
"applies_to"
]
},
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"condition": {
"type": "string",
"enum": [
"at_most",
"exactly",
"at_least"
]
}
},
"required": [
"value",
"condition"
]
},
{
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the default selected values (assets, linked items, multiple choice options, or taxonomy terms, depending on the element type)."
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
{
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "string"
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
{
"type": "object",
"properties": {
"global": {
"type": "object",
"properties": {
"value": {
"type": "number"
}
},
"required": [
"value"
]
}
},
"required": [
"global"
]
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{}
]
}
},
"required": [
"op",
"path"
]
}
]
},
"description": "Patch operations array. CRITICAL: Always call get-content-type-snippet first.\n- Use addInto/remove for arrays, replace for primitives/objects\n- Snippets cannot contain: content_groups, snippet, or url_slug elements"
}
},
"required": [
"patchGuideId",
"id",
"operations"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
patch-languageUpdate (modify/edit) Kontent.ai language properties using replace patch operations. Always call get-patch-guide(entityType='language') first — it documents constraints and available properties not visible in this schema.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"patchGuideId": {
"type": "string",
"description": "The patchGuideId value returned by the get-patch-guide(entityType='language') tool result in this conversation. Call get-patch-guide(entityType='language') first if you have not done so, then copy the patchGuideId it returned here — this confirms you received and read the patch guide before constructing operations."
},
"languageId": {
"type": "string",
"description": "Language ID to modify"
},
"operations": {
"minItems": 1,
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "replace"
},
"property_name": {
"type": "string",
"const": "codename"
},
"value": {
"type": "string"
}
},
"required": [
"op",
"property_name",
"value"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "replace"
},
"property_name": {
"type": "string",
"const": "name"
},
"value": {
"type": "string"
}
},
"required": [
"op",
"property_name",
"value"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "replace"
},
"property_name": {
"type": "string",
"const": "fallback_language"
},
"value": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the new fallback language."
}
},
"required": [
"op",
"property_name",
"value"
]
}
]
},
"description": "Array of replace operations for codename, name, or fallback_language. Note: Only active languages can be modified. To activate/deactivate languages, use the Kontent.ai web UI."
}
},
"required": [
"patchGuideId",
"languageId",
"operations"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
patch-spaceUpdate (modify/edit) Kontent.ai space properties using replace patch operations. Always call get-patch-guide(entityType='space') first for operations reference.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"patchGuideId": {
"type": "string",
"description": "The patchGuideId value returned by the get-patch-guide(entityType='space') tool result in this conversation. Call get-patch-guide(entityType='space') first if you have not done so, then copy the patchGuideId it returned here — this confirms you received and read the patch guide before constructing operations."
},
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Space ID"
},
"operations": {
"minItems": 1,
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "replace"
},
"property_name": {
"type": "string",
"const": "name"
},
"value": {
"type": "string"
}
},
"required": [
"op",
"property_name",
"value"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "replace"
},
"property_name": {
"type": "string",
"const": "codename"
},
"value": {
"type": "string"
}
},
"required": [
"op",
"property_name",
"value"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "replace"
},
"property_name": {
"type": "string",
"const": "collections"
},
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the collections this space includes."
}
},
"required": [
"op",
"property_name",
"value"
]
}
]
}
}
},
"required": [
"patchGuideId",
"id",
"operations"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
patch-taxonomy-groupUpdate (modify/edit) and organize Kontent.ai taxonomy group terms using patch operations. Always call get-patch-guide(entityType='taxonomy') first — it documents ordering rules and constraints not visible in this schema.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"patchGuideId": {
"type": "string",
"description": "The patchGuideId value returned by the get-patch-guide(entityType='taxonomy') tool result in this conversation. Call get-patch-guide(entityType='taxonomy') first if you have not done so, then copy the patchGuideId it returned here — this confirms you received and read the patch guide before constructing operations."
},
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Taxonomy group ID"
},
"operations": {
"minItems": 1,
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "addInto"
},
"reference": {
"description": "Parent term reference. Omit to add at root level of taxonomy group.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"value": {
"$ref": "#/definitions/__schema0"
},
"before": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the sibling term to insert before."
}
},
"required": [
"op",
"value",
"before"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "addInto"
},
"reference": {
"description": "Parent term reference. Omit to add at root level of taxonomy group.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"value": {
"$ref": "#/definitions/__schema0"
},
"after": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the sibling term to insert after."
}
},
"required": [
"op",
"value",
"after"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "addInto"
},
"reference": {
"description": "Parent term reference. Omit to add at root level of taxonomy group.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"value": {
"$ref": "#/definitions/__schema0"
}
},
"required": [
"op",
"value"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "move"
},
"reference": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the term to move."
},
"before": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the sibling term to move before."
}
},
"required": [
"op",
"reference",
"before"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "move"
},
"reference": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the term to move."
},
"after": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the sibling term to move after."
}
},
"required": [
"op",
"reference",
"after"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "move"
},
"reference": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the term to move."
},
"under": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Move as child of this term (tree nesting)"
}
},
"required": [
"op",
"reference",
"under"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "remove"
},
"reference": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the term to remove."
}
},
"required": [
"op",
"reference"
]
},
{
"type": "object",
"properties": {
"op": {
"type": "string",
"const": "replace"
},
"reference": {
"description": "Term reference. Omit when modifying group-level properties (name, codename). Required when modifying specific term.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"property_name": {
"type": "string",
"enum": [
"name",
"codename",
"terms"
]
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
}
],
"description": "New value. String for name/codename, array for terms."
}
},
"required": [
"op",
"property_name",
"value"
]
}
]
},
"description": "Patch operations array. Call get-taxonomy-group first. Use addInto to add terms (with optional reference for parent), move to reorder/nest terms (before/after/under - mutually exclusive), remove to delete terms, replace for name/codename/terms."
}
},
"required": [
"patchGuideId",
"id",
"operations"
],
"definitions": {
"__schema0": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"codename": {
"type": "string"
},
"external_id": {
"type": "string"
},
"terms": {
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
}
},
"required": [
"name"
]
}
}
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
publish-content-item-variantPublish or schedule publishing of Kontent.ai content item variant (language version/translation). Transitions content to the published workflow step, making it live. For scheduling, verify current UTC time before using scheduledTo.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"itemId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Content item ID"
},
"languageId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Language ID (default: 00000000-0000-0000-0000-000000000000)"
},
"scheduledTo": {
"description": "ISO 8601 datetime for scheduled publish (omit for immediate)",
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"displayTimezone": {
"description": "Timezone for UI display (e.g., America/New_York, UTC)",
"type": "string"
}
},
"required": [
"itemId",
"languageId"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
search-content-item-variantsAI semantic search for Kontent.ai content items with content item variants (language versions/translations) by topic, theme, or meaning. Use when you know what content is *about* — not when looking for an item by name or title; use list-content-item-variants for that. Returns lightweight references, top 50 results max. This feature may be unavailable.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"searchPhrase": {
"type": "string",
"description": "Search phrase for AI-powered semantic search. Uses vector database to find content by meaning and similarity, not just exact keyword matching"
},
"filter": {
"type": "object",
"properties": {
"variantId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Language ID from list-languages. Use default language (is_default=true) if not specified by user."
}
},
"required": [
"variantId"
]
}
},
"required": [
"searchPhrase",
"filter"
]
}Annotations{
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false
} | — | — |
unpublish-content-item-variantUnpublish or schedule unpublishing of Kontent.ai content item variant (language version/translation). Takes content offline and archives it. For scheduling, verify current UTC time before using scheduledTo.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"itemId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Content item ID"
},
"languageId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Language ID (default: 00000000-0000-0000-0000-000000000000)"
},
"scheduledTo": {
"description": "ISO 8601 datetime for scheduled unpublish (omit for immediate)",
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"displayTimezone": {
"description": "Timezone for UI display (e.g., America/New_York, UTC)",
"type": "string"
}
},
"required": [
"itemId",
"languageId"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
update-assetUpdate (edit) Kontent.ai asset metadata by ID. Modify asset title, descriptions, or taxonomy-based properties.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Asset ID"
},
"data": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"codename": {
"type": "string"
},
"collection": {
"type": "object",
"properties": {
"reference": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the collection to assign this asset to."
}
},
"required": [
"reference"
]
},
"folder": {
"description": "Reference to the destination asset folder.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"descriptions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"language": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the language this description is written in."
},
"description": {
"type": "string"
}
},
"required": [
"language",
"description"
]
}
},
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the taxonomy element this value is for."
},
"value": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Array of references to the selected taxonomy terms."
}
},
"required": [
"element",
"value"
]
}
}
},
"description": "Only include properties you want to update; omitted fields retain existing values."
}
},
"required": [
"id",
"data"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
update-content-itemUpdate (edit/rename) Kontent.ai content item metadata: name, collection.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Content item ID"
},
"name": {
"description": "New name (1-200 chars)",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"collection": {
"description": "Reference to the collection this item belongs to.",
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
"required": [
"id"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
update-content-item-variantUpdate Kontent.ai content item variant (language version/translation). Send only the elements you want to change — omitted elements are left untouched on the existing variant. Values must fulfill validation rules defined in the content type.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"itemId": {
"type": "string",
"description": "Content item ID"
},
"languageId": {
"type": "string",
"description": "Language ID (default: 00000000-0000-0000-0000-000000000000)"
},
"elements": {
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
},
"description": "Element values to set"
},
"workflow_step_id": {
"description": "Workflow step ID",
"type": "string"
},
"note": {
"description": "Additional plain text only instructions or notes for content creators. Use line breaks/dashes for structure.",
"type": "string",
"maxLength": 4000
}
},
"required": [
"itemId",
"languageId",
"elements"
],
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"mode": {
"type": "string",
"enum": [
"autogenerated",
"custom"
],
"description": "REQUIRED on every URL slug element. 'autogenerated' (system-generated based on dependent text element) or 'custom' (manual). Switches to custom when value is directly modified."
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "URL-friendly slug value for SEO. Always send it together with 'mode' — a URL slug element sent without 'mode' is rejected by the Management API."
}
},
"required": [
"element",
"mode",
"value"
],
"description": "URL slug element - URL-friendly slug for SEO. Can be auto-generated from dependent text element or custom."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 100000
},
{
"type": "null"
}
],
"description": "Valid HTML5 fragment. Defaults to '<p><br/></p>' if empty."
},
"components": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier of the component within the rich text element."
},
"type": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type defining the component structure."
},
"elements": {
"anyOf": [
{
"type": "array",
"items": {
"description": "Element value within a component - same structure as top-level variant elements.",
"allOf": [
{
"$ref": "#/definitions/__schema0"
}
]
}
},
{
"type": "null"
}
],
"description": "Array of element values within the component (supports up to 6 levels deep nesting)."
}
},
"required": [
"id",
"type",
"elements"
],
"description": "Component embedded in rich text - a reusable content block defined by a content type."
}
},
{
"type": "null"
}
],
"description": "Array of nested component objects that can be embedded in the rich text content."
}
},
"required": [
"element",
"value",
"components"
],
"description": "Rich text element - formatted HTML content that can include embedded assets, components, content items, and links. Always submit the value together with the complete components array; on update, include components that should remain unchanged alongside any changes."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
{
"type": "null"
}
]
},
"display_timezone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "IANA time zone name affecting UI display without modifying stored value. Defaults to null (local time zone)."
}
},
"required": [
"element",
"value",
"display_timezone"
],
"description": "Date & time element - stores date and time values in UTC with optional display timezone."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 200000
},
{
"type": "null"
}
],
"description": "Custom-formatted data depending on the specific custom element implementation."
},
"searchable_value": {
"anyOf": [
{
"type": "string",
"maxLength": 200000
},
{
"type": "null"
}
],
"description": "Plain text for search functionality in content item lists."
}
},
"required": [
"element",
"value",
"searchable_value"
],
"description": "Custom element - stores custom-formatted data with optional searchable plain text representation."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Floating-point number."
}
},
"required": [
"element",
"value"
],
"description": "Number element - stores numeric floating-point values."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
{
"type": "null"
}
],
"description": "Array of Reference objects, each representing a single asset. Every asset can be referenced only once."
}
},
"required": [
"element",
"value"
],
"description": "Asset element - references to assets (images, documents). Supports renditions for image-specific editions."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
{
"type": "null"
}
],
"description": "Array of Reference objects. Each reference represents a single content item (each item referenced only once)."
}
},
"required": [
"element",
"value"
],
"description": "Linked items element - references to other content items for modular content."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
{
"type": "null"
}
],
"description": "Array of Reference objects. Each reference represents one of the multiple choice options defined in content type."
}
},
"required": [
"element",
"value"
],
"description": "Multiple choice element - references to selected choice options. Single-option mode requires exactly one reference."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
},
{
"type": "null"
}
],
"description": "Array of Reference objects. Each reference represents a taxonomy term (each term referenced only once)."
}
},
"required": [
"element",
"value"
],
"description": "Taxonomy element - references to taxonomy terms from a taxonomy group."
},
{
"type": "object",
"properties": {
"element": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
},
"description": "Reference to the content type element this value is for."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 100000
},
{
"type": "null"
}
],
"description": "Plain text content."
}
},
"required": [
"element",
"value"
],
"description": "Text element - stores plain text content."
}
]
}
}
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
update-workflowUpdate (edit) Kontent.ai workflow steps, transitions, and settings. Modify content lifecycle stages.Input schema{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$",
"description": "Workflow ID"
},
"name": {
"type": "string",
"description": "Human-readable name of the workflow"
},
"codename": {
"description": "Codename for API operations (auto-generated if omitted)",
"type": "string"
},
"scopes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"content_types": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
},
"description": "Content types this workflow applies to"
},
"collections": {
"description": "Collections this workflow applies to",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"external_id": {
"type": "string"
}
}
}
}
},
"required": [
"content_types"
]
},
"description": "Array of scopes defining which combinations of content types and collections this workflow applies to. If both content types and collections are empty, the workflow can be used for any type of content in collection that isn't limited to any other workflow."
},
"steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Human-readable name of the workflow step"
},
"codename": {
"type": "string",
"description": "Codename of the workflow step. Must be unique across all workflows - usually prepended with the workflow codename."
},
"id": {
"readOnly": true,
"description": "Read-only workflow step ID (useful to reference a step when updating its codename)",
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"color": {
"type": "string",
"enum": [
"gray",
"red",
"rose",
"light-purple",
"dark-purple",
"dark-blue",
"light-blue",
"sky-blue",
"mint-green",
"persian-green",
"dark-green",
"light-green",
"yellow",
"pink",
"orange",
"brown"
],
"description": "Color of the workflow step displayed in the UI"
},
"transitions_to": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"step": {
"type": "object",
"properties": {
"codename": {
"description": "Target step codename",
"type": "string"
},
"id": {
"description": "Target step ID (for update operations)",
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
}
},
"description": "Reference to the target step"
}
},
"required": [
"step"
]
},
"description": "Array of step references this step can transition to. Every custom step must eventually be able to reach the built-in 'published' step, whether directly or via a chain through other custom steps (reference the published step as {\"step\":{\"codename\":\"published\"}}) - a step with no path to Published makes the workflow invalid."
},
"role_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"description": "Array of role IDs that have permissions for this step. Leave empty to allow all roles."
}
},
"required": [
"name",
"codename",
"color",
"transitions_to",
"role_ids"
]
},
"description": "Array of custom workflow steps. Every step's transitions_to must form a path that eventually reaches the built-in 'published' step (directly or through other custom steps) - a step with no route to Published makes the whole workflow invalid."
},
"published_step": {
"type": "object",
"properties": {
"unpublish_role_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"description": "Array of role IDs that can unpublish content. Leave empty to allow all roles."
},
"create_new_version_role_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"description": "Array of role IDs that can create new versions. Leave empty to allow all roles."
}
},
"required": [
"unpublish_role_ids",
"create_new_version_role_ids"
],
"description": "Configuration for the published step"
},
"archived_step": {
"type": "object",
"properties": {
"role_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
},
"description": "Array of role IDs that can restore archived content. Leave empty to allow all roles."
}
},
"required": [
"role_ids"
],
"description": "Configuration for the archived step"
}
},
"required": [
"id",
"name",
"scopes",
"steps",
"published_step",
"archived_step"
]
}Annotations{
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
} | — | — |
No completed comparison is available.
| Risk | Change | Subject |
|---|---|---|
| No material changes recorded. | ||
| Severity | Finding | Advisory |
|---|---|---|
| No confirmed vulnerability is published for this version. | ||
Artifact SHA-256: 10d4a808bb66b9f36895e3a00db565bb6b83b8cd3f97b73e5bfef24001b50578
Scanner: mcp-proof-engine 0.1.0.