---
title: Create content
slug: cms-13/api/create-content
docTags:
createdAt: 2026-08-28T15:24:16.532Z
---
{
"id": "wgSf3odXs2wxKsyHaEFbh",
"type": "api-oas-v2",
"data": {
"method": "POST",
"url": "/_cms/v1/content",
"servers": [
{
"url": "/_cms/v1/content",
"description": "Optimizely CMS API"
}
],
"name": "Create content",
"description": "Create a new content item.",
"contentType": "application/json",
"request": {
"pathParameters": [],
"headerParameters": [
{
"name": "accept",
"type": "string",
"kind": "optional",
"description": "Generated from available response content types",
"enum": [
"application/json"
],
"default": "application/json"
},
{
"kind": "optional",
"name": "cms-skip-validation",
"type": "array",
"description": "Indicates which content validation rules should be bypassed. Supported values are '*' (skip all validations), 'data' (skip data validation), and 'references' (skip reference validation). Values can be combined, empty or duplicated values are ignored, and any unknown values result in a validation error. Use with caution as this may allow creation of invalid content that could cause issues in production.
",
"schema": [],
"itemType": "string",
"customType": "string[]"
},
{
"kind": "optional",
"name": "Prefer",
"type": "array",
"example": "[\"return=representation\"]",
"description": "Indicates client preference for the response content as per IETF RFC7240. Currently only supports 'return=representation' which can be used to indicate a preference to receive a representation of the resource that has been altered in the response.
",
"schema": [],
"itemType": "string",
"customType": "string[]"
}
],
"queryParameters": [],
"bodyDataParameters": [
{
"kind": "required",
"name": "body",
"type": "object",
"description": "The content item that should be created.",
"customType": "NewContent",
"schema": [
{
"name": "key",
"kind": "optional",
"type": "string",
"description": "The key that identifies the content item to be created. If not provided, a new key will be generated.
"
},
{
"name": "contentType",
"kind": "required",
"type": "string",
"description": "The content type for the content item to be created.",
"minLength": 1
},
{
"name": "container",
"kind": "optional",
"type": "string",
"description": "The key that identifies the container content where this content item should be created."
},
{
"name": "owner",
"kind": "optional",
"type": "string",
"description": "The key that identifies the owner for the content item to be created. Content that is owned by another content is also known as an asset."
},
{
"name": "initialVersion",
"kind": "required",
"type": "object",
"description": "Represents a version of a content item.",
"modelRef": "#/components/schemas/ContentVersion",
"customType": "ContentVersion",
"schema": [],
"complexType": "allOf",
"complexItems": [
{
"name": "ContentData",
"description": "",
"modelRef": "#/components/schemas/ContentData",
"schema": [
{
"name": "binding",
"kind": "optional",
"type": "object",
"description": "Associates a content item with another source content item, establishing a relationship defined by a content type binding. Used for linking managed content to external or reference content.
",
"modelRef": "#/components/schemas/ContentBinding",
"customType": "ContentBinding",
"schema": [
{
"name": "contentTypeBinding",
"kind": "optional",
"type": "string",
"description": "The binding definition key that controls how the source content item is linked and accessed."
},
{
"name": "source",
"kind": "required",
"type": "string",
"description": "The reference to the source content item that is being bound. This cannot be empty.",
"format": "uri"
}
]
},
{
"name": "properties",
"kind": "optional",
"type": "map",
"description": "Properties as they are defined by corresponding component or content type.",
"example": "",
"customType": "map",
"schema": []
}
]
},
{
"name": "object",
"description": "",
"schema": [
{
"name": "key",
"kind": "optional",
"type": "string",
"description": "The key that identifies this content version."
},
{
"name": "locale",
"kind": "optional",
"type": "string",
"description": "The locale of this content version."
},
{
"name": "version",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The version identifier of this instance."
},
{
"name": "variation",
"kind": "optional",
"type": "string",
"description": "The variation of this content version, if any. Variations are used to represent different states or forms of the same content item. A variation has its own publishing lifecycle. A variation cannot be published before the default version of same locale has been published.
"
},
{
"name": "contentType",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The content type of this content item."
},
{
"name": "displayName",
"kind": "required",
"type": "string",
"description": "The display name of this content version.",
"minLength": 1,
"maxLength": 255
},
{
"name": "published",
"kind": "optional",
"type": "string",
"nullable": true,
"description": "Indicates a time when this content was published or should be published.",
"format": "date-time"
},
{
"name": "expired",
"kind": "optional",
"type": "string",
"nullable": true,
"description": "Indicates a time when this content expired or should expire.",
"format": "date-time"
},
{
"name": "status",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The status of this content version.",
"enum": [
"draft",
"ready",
"published",
"previous",
"scheduled",
"rejected",
"inReview"
]
},
{
"name": "delayPublishUntil",
"kind": "optional",
"type": "string",
"readOnly": true,
"nullable": true,
"description": "The timestamp when a scheduled version will be published. Only present when status is 'scheduled'.",
"format": "date-time"
},
{
"name": "routeSegment",
"kind": "optional",
"type": "string",
"description": "A string that represents the segment that should be used when routing or generating routes to the current content instance. This value will always be null when content is based on a non-routable content type.
",
"maxLength": 255
},
{
"name": "simpleRoute",
"kind": "optional",
"type": "string",
"description": "A simple route (shortcut URL) used to access pages and experiences.
",
"maxLength": 253,
"pattern": "^[^/].*$"
},
{
"name": "lastModified",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "",
"format": "date-time"
},
{
"name": "lastModifiedBy",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": ""
},
{
"name": "composition",
"kind": "optional",
"type": "object",
"description": "Specifies a node in a content composition.",
"modelRef": "#/components/schemas/CompositionNode",
"customType": "CompositionNode",
"schema": [
{
"name": "id",
"kind": "optional",
"type": "string",
"description": "Specifies an identifier of this CompositionNode."
},
{
"name": "displayName",
"kind": "optional",
"type": "string",
"description": "The display name of this ContentType.",
"maxLength": 255
},
{
"name": "nodeType",
"kind": "required",
"type": "string",
"description": "The node type of this CompositionNode.",
"minLength": 1
},
{
"name": "layoutType",
"kind": "optional",
"type": "string",
"description": "The node layout type of this CompositionNode"
},
{
"name": "displaySettings",
"kind": "optional",
"type": "object",
"description": "Defines display settings for a CompositionNode.",
"modelRef": "#/components/schemas/CompositionDisplaySettings",
"customType": "CompositionDisplaySettings",
"schema": [
{
"name": "displayTemplate",
"kind": "required",
"type": "string",
"description": "The display template that these settings apply to.",
"minLength": 1
},
{
"name": "settings",
"kind": "optional",
"type": "map",
"nullable": true,
"description": "The display settings of this CompositionNode.",
"example": "",
"customType": "map",
"schema": []
}
]
},
{
"name": "component",
"kind": "optional",
"type": "object",
"description": "Represents a content component.",
"modelRef": "#/components/schemas/ContentComponent",
"customType": "ContentComponent",
"schema": [],
"complexType": "allOf",
"complexItems": [
{
"name": "ContentData",
"description": "",
"modelRef": "#/components/schemas/ContentData",
"schema": [
{
"name": "",
"description": "",
"customType": "Circular-Reference"
}
]
},
{
"name": "object",
"description": "",
"schema": [
{
"name": "reference",
"kind": "optional",
"type": "string",
"nullable": true,
"description": "A reference to the content of this component. Cannot be assigned together with 'contentType' or 'properties'.",
"format": "uri"
},
{
"name": "contentType",
"kind": "optional",
"type": "string",
"description": "The key of the content type that this is an embedded instance of."
}
]
}
]
},
{
"name": "nodes",
"kind": "optional",
"type": "array",
"nullable": true,
"description": "The child nodes for this CompositionNode.",
"modelRef": "#/components/schemas/CompositionNode",
"customType": "CompositionNode[]",
"schema": [
{
"name": "",
"description": "",
"customType": "Circular-Reference"
}
]
}
]
},
{
"name": "media",
"kind": "optional",
"type": "object",
"description": "Represents media data attached to a content item.",
"modelRef": "#/components/schemas/MediaData",
"customType": "MediaData",
"schema": [
{
"name": "key",
"kind": "optional",
"type": "string",
"description": "The key referencing the media.",
"pattern": "^[a-f0-9]{32}\\.[a-zA-Z0-9]{1,20}$"
}
]
}
]
}
]
}
],
"modelRef": "#/components/schemas/NewContent",
"isExpanded": true
}
],
"formDataParameters": [],
"oAuthParameters": [
{
"id": "apiAuth",
"name": "apiAuth",
"kind": "optional",
"type": "oauth2",
"description": "Use this scheme to generate an access token that can be used to access the API.",
"oauth2Flows": {
"clientCredentials": {
"tokenUrl": "/_cms/v1/oauth/token",
"scopes": {
"api:admin": "Grants full administrative access to the API"
}
}
},
"requiredScopes": [
"api:admin"
]
}
],
"cookieParameters": []
},
"responses": [
{
"statusCode": "201",
"description": "Created",
"jsonExample": "",
"isExpanded": true,
"headers": [
{
"kind": "optional",
"name": "ETag",
"type": "string",
"description": "The RFC7232 ETag header field in a response provides the current entity-tag for the resource. An entity-tag is an opaque identifier for different versions of a resource over time, regardless whether multiple versions are valid at the same time.
"
},
{
"kind": "optional",
"name": "Last-Modified",
"type": "string",
"description": "The date and time at which the resource was last modified.",
"format": "http-date"
},
{
"kind": "optional",
"name": "Location",
"type": "string",
"description": "Indicates the URL of the newly-created resource.
"
},
{
"kind": "optional",
"name": "Preference-Applied",
"description": ""
}
],
"schema": [
{
"kind": "optional",
"type": "object",
"description": "Represents the result of creating a new content item.",
"customType": "NewContentNode",
"schema": [
{
"name": "key",
"kind": "optional",
"type": "string",
"description": "The unique identifier (key) of the resource.
"
},
{
"name": "container",
"kind": "optional",
"type": "string",
"description": "The content item that contains this item in the hierarchy."
},
{
"name": "owner",
"kind": "optional",
"type": "string",
"description": "The content item that owns this item. Content that is owned by another content is also known as an asset. Cannot be combined with container."
},
{
"name": "contentType",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The content type that defines the structure and available properties for this item."
},
{
"name": "primaryLocale",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The locale for which this content was originally created. This locale will include properties that are shared across all locales."
},
{
"name": "locales",
"kind": "optional",
"type": "array",
"readOnly": true,
"description": "The complete list of locales for which this content has been created for.",
"example": "",
"itemType": "string",
"customType": "string[]",
"itemExample": "",
"itemDefault": ""
},
{
"name": "lastModified",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The date and time when this content was last modified.",
"format": "date-time"
},
{
"name": "lastModifiedBy",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The username of the user that last modified this content."
},
{
"name": "created",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The date and time when this content was first created.",
"format": "date-time"
},
{
"name": "createdBy",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The username of the user who created this content."
},
{
"name": "deleted",
"kind": "optional",
"type": "string",
"readOnly": true,
"nullable": true,
"description": "If populated, the date and time when this content was deleted.
",
"format": "date-time"
},
{
"name": "deletedBy",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The username of the user who deleted this content. Only populated if the content is deleted."
},
{
"name": "initialVersion",
"kind": "optional",
"type": "object",
"description": "Represents a version of a content item.",
"modelRef": "#/components/schemas/ContentVersion",
"customType": "ContentVersion",
"schema": [],
"complexType": "allOf",
"complexItems": [
{
"name": "ContentData",
"description": "",
"modelRef": "#/components/schemas/ContentData",
"schema": [
{
"name": "binding",
"kind": "optional",
"type": "object",
"description": "Associates a content item with another source content item, establishing a relationship defined by a content type binding. Used for linking managed content to external or reference content.
",
"modelRef": "#/components/schemas/ContentBinding",
"customType": "ContentBinding",
"schema": [
{
"name": "contentTypeBinding",
"kind": "optional",
"type": "string",
"description": "The binding definition key that controls how the source content item is linked and accessed."
},
{
"name": "source",
"kind": "required",
"type": "string",
"description": "The reference to the source content item that is being bound. This cannot be empty.",
"format": "uri"
}
]
},
{
"name": "properties",
"kind": "optional",
"type": "map",
"description": "Properties as they are defined by corresponding component or content type.",
"example": "",
"customType": "map",
"schema": []
}
]
},
{
"name": "object",
"description": "",
"schema": [
{
"name": "key",
"kind": "optional",
"type": "string",
"description": "The key that identifies this content version."
},
{
"name": "locale",
"kind": "optional",
"type": "string",
"description": "The locale of this content version."
},
{
"name": "version",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The version identifier of this instance."
},
{
"name": "variation",
"kind": "optional",
"type": "string",
"description": "The variation of this content version, if any. Variations are used to represent different states or forms of the same content item. A variation has its own publishing lifecycle. A variation cannot be published before the default version of same locale has been published.
"
},
{
"name": "contentType",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The content type of this content item."
},
{
"name": "displayName",
"kind": "required",
"type": "string",
"description": "The display name of this content version.",
"minLength": 1,
"maxLength": 255
},
{
"name": "published",
"kind": "optional",
"type": "string",
"nullable": true,
"description": "Indicates a time when this content was published or should be published.",
"format": "date-time"
},
{
"name": "expired",
"kind": "optional",
"type": "string",
"nullable": true,
"description": "Indicates a time when this content expired or should expire.",
"format": "date-time"
},
{
"name": "status",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The status of this content version.",
"enum": [
"draft",
"ready",
"published",
"previous",
"scheduled",
"rejected",
"inReview"
]
},
{
"name": "delayPublishUntil",
"kind": "optional",
"type": "string",
"readOnly": true,
"nullable": true,
"description": "The timestamp when a scheduled version will be published. Only present when status is 'scheduled'.",
"format": "date-time"
},
{
"name": "routeSegment",
"kind": "optional",
"type": "string",
"description": "A string that represents the segment that should be used when routing or generating routes to the current content instance. This value will always be null when content is based on a non-routable content type.
",
"maxLength": 255
},
{
"name": "simpleRoute",
"kind": "optional",
"type": "string",
"description": "A simple route (shortcut URL) used to access pages and experiences.
",
"maxLength": 253,
"pattern": "^[^/].*$"
},
{
"name": "lastModified",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "",
"format": "date-time"
},
{
"name": "lastModifiedBy",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": ""
},
{
"name": "composition",
"kind": "optional",
"type": "object",
"description": "Specifies a node in a content composition.",
"modelRef": "#/components/schemas/CompositionNode",
"customType": "CompositionNode",
"schema": [
{
"name": "id",
"kind": "optional",
"type": "string",
"description": "Specifies an identifier of this CompositionNode."
},
{
"name": "displayName",
"kind": "optional",
"type": "string",
"description": "The display name of this ContentType.",
"maxLength": 255
},
{
"name": "nodeType",
"kind": "required",
"type": "string",
"description": "The node type of this CompositionNode.",
"minLength": 1
},
{
"name": "layoutType",
"kind": "optional",
"type": "string",
"description": "The node layout type of this CompositionNode"
},
{
"name": "displaySettings",
"kind": "optional",
"type": "object",
"description": "Defines display settings for a CompositionNode.",
"modelRef": "#/components/schemas/CompositionDisplaySettings",
"customType": "CompositionDisplaySettings",
"schema": [
{
"name": "displayTemplate",
"kind": "required",
"type": "string",
"description": "The display template that these settings apply to.",
"minLength": 1
},
{
"name": "settings",
"kind": "optional",
"type": "map",
"nullable": true,
"description": "The display settings of this CompositionNode.",
"example": "",
"customType": "map",
"schema": []
}
]
},
{
"name": "component",
"kind": "optional",
"type": "object",
"description": "Represents a content component.",
"modelRef": "#/components/schemas/ContentComponent",
"customType": "ContentComponent",
"schema": [],
"complexType": "allOf",
"complexItems": [
{
"name": "ContentData",
"description": "",
"modelRef": "#/components/schemas/ContentData",
"schema": [
{
"name": "binding",
"kind": "optional",
"type": "object",
"description": "Associates a content item with another source content item, establishing a relationship defined by a content type binding. Used for linking managed content to external or reference content.
",
"modelRef": "#/components/schemas/ContentBinding",
"customType": "ContentBinding",
"schema": [
{
"name": "contentTypeBinding",
"kind": "optional",
"type": "string",
"description": "The binding definition key that controls how the source content item is linked and accessed."
},
{
"name": "source",
"kind": "required",
"type": "string",
"description": "The reference to the source content item that is being bound. This cannot be empty.",
"format": "uri"
}
]
},
{
"name": "properties",
"kind": "optional",
"type": "map",
"description": "Properties as they are defined by corresponding component or content type.",
"example": "",
"customType": "map",
"schema": []
}
]
},
{
"name": "object",
"description": "",
"schema": [
{
"name": "reference",
"kind": "optional",
"type": "string",
"nullable": true,
"description": "A reference to the content of this component. Cannot be assigned together with 'contentType' or 'properties'.",
"format": "uri"
},
{
"name": "contentType",
"kind": "optional",
"type": "string",
"description": "The key of the content type that this is an embedded instance of."
}
]
}
]
},
{
"name": "nodes",
"kind": "optional",
"type": "array",
"nullable": true,
"description": "The child nodes for this CompositionNode.",
"modelRef": "#/components/schemas/CompositionNode",
"customType": "CompositionNode[]",
"schema": [
{
"name": "",
"description": "",
"customType": "Circular-Reference"
}
]
}
]
},
{
"name": "media",
"kind": "optional",
"type": "object",
"description": "Represents media data attached to a content item.",
"modelRef": "#/components/schemas/MediaData",
"customType": "MediaData",
"schema": [
{
"name": "key",
"kind": "optional",
"type": "string",
"description": "The key referencing the media.",
"pattern": "^[a-f0-9]{32}\\.[a-zA-Z0-9]{1,20}$"
}
]
}
]
}
]
}
],
"modelRef": "#/components/schemas/NewContentNode",
"complexItems": [
{
"name": "object",
"schema": [
{
"name": "key",
"kind": "optional",
"type": "string",
"description": "The unique identifier (key) of the resource.
"
},
{
"name": "container",
"kind": "optional",
"type": "string",
"description": "The content item that contains this item in the hierarchy."
},
{
"name": "owner",
"kind": "optional",
"type": "string",
"description": "The content item that owns this item. Content that is owned by another content is also known as an asset. Cannot be combined with container."
},
{
"name": "contentType",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The content type that defines the structure and available properties for this item."
},
{
"name": "primaryLocale",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The locale for which this content was originally created. This locale will include properties that are shared across all locales."
},
{
"name": "locales",
"kind": "optional",
"type": "array",
"readOnly": true,
"description": "The complete list of locales for which this content has been created for.",
"example": "",
"itemType": "string",
"customType": "string[]",
"itemExample": "",
"itemDefault": ""
},
{
"name": "lastModified",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The date and time when this content was last modified.",
"format": "date-time"
},
{
"name": "lastModifiedBy",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The username of the user that last modified this content."
},
{
"name": "created",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The date and time when this content was first created.",
"format": "date-time"
},
{
"name": "createdBy",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The username of the user who created this content."
},
{
"name": "deleted",
"kind": "optional",
"type": "string",
"readOnly": true,
"nullable": true,
"description": "If populated, the date and time when this content was deleted.
",
"format": "date-time"
},
{
"name": "deletedBy",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The username of the user who deleted this content. Only populated if the content is deleted."
}
],
"modelRef": "#/components/schemas/ContentNode",
"customType": "ContentNode"
},
{
"name": "object",
"schema": [
{
"name": "initialVersion",
"kind": "optional",
"type": "object",
"description": "Represents a version of a content item.",
"modelRef": "#/components/schemas/ContentVersion",
"customType": "ContentVersion",
"schema": [],
"complexType": "allOf",
"complexItems": [
{
"name": "ContentData",
"description": "",
"modelRef": "#/components/schemas/ContentData",
"schema": [
{
"name": "binding",
"kind": "optional",
"type": "object",
"description": "Associates a content item with another source content item, establishing a relationship defined by a content type binding. Used for linking managed content to external or reference content.
",
"modelRef": "#/components/schemas/ContentBinding",
"customType": "ContentBinding",
"schema": [
{
"name": "contentTypeBinding",
"kind": "optional",
"type": "string",
"description": "The binding definition key that controls how the source content item is linked and accessed."
},
{
"name": "source",
"kind": "required",
"type": "string",
"description": "The reference to the source content item that is being bound. This cannot be empty.",
"format": "uri"
}
]
},
{
"name": "properties",
"kind": "optional",
"type": "map",
"description": "Properties as they are defined by corresponding component or content type.",
"example": "",
"customType": "map",
"schema": []
}
]
},
{
"name": "object",
"description": "",
"schema": [
{
"name": "key",
"kind": "optional",
"type": "string",
"description": "The key that identifies this content version."
},
{
"name": "locale",
"kind": "optional",
"type": "string",
"description": "The locale of this content version."
},
{
"name": "version",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The version identifier of this instance."
},
{
"name": "variation",
"kind": "optional",
"type": "string",
"description": "The variation of this content version, if any. Variations are used to represent different states or forms of the same content item. A variation has its own publishing lifecycle. A variation cannot be published before the default version of same locale has been published.
"
},
{
"name": "contentType",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The content type of this content item."
},
{
"name": "displayName",
"kind": "required",
"type": "string",
"description": "The display name of this content version.",
"minLength": 1,
"maxLength": 255
},
{
"name": "published",
"kind": "optional",
"type": "string",
"nullable": true,
"description": "Indicates a time when this content was published or should be published.",
"format": "date-time"
},
{
"name": "expired",
"kind": "optional",
"type": "string",
"nullable": true,
"description": "Indicates a time when this content expired or should expire.",
"format": "date-time"
},
{
"name": "status",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The status of this content version.",
"enum": [
"draft",
"ready",
"published",
"previous",
"scheduled",
"rejected",
"inReview"
]
},
{
"name": "delayPublishUntil",
"kind": "optional",
"type": "string",
"readOnly": true,
"nullable": true,
"description": "The timestamp when a scheduled version will be published. Only present when status is 'scheduled'.",
"format": "date-time"
},
{
"name": "routeSegment",
"kind": "optional",
"type": "string",
"description": "A string that represents the segment that should be used when routing or generating routes to the current content instance. This value will always be null when content is based on a non-routable content type.
",
"maxLength": 255
},
{
"name": "simpleRoute",
"kind": "optional",
"type": "string",
"description": "A simple route (shortcut URL) used to access pages and experiences.
",
"maxLength": 253,
"pattern": "^[^/].*$"
},
{
"name": "lastModified",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "",
"format": "date-time"
},
{
"name": "lastModifiedBy",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": ""
},
{
"name": "composition",
"kind": "optional",
"type": "object",
"description": "Specifies a node in a content composition.",
"modelRef": "#/components/schemas/CompositionNode",
"customType": "CompositionNode",
"schema": [
{
"name": "id",
"kind": "optional",
"type": "string",
"description": "Specifies an identifier of this CompositionNode."
},
{
"name": "displayName",
"kind": "optional",
"type": "string",
"description": "The display name of this ContentType.",
"maxLength": 255
},
{
"name": "nodeType",
"kind": "required",
"type": "string",
"description": "The node type of this CompositionNode.",
"minLength": 1
},
{
"name": "layoutType",
"kind": "optional",
"type": "string",
"description": "The node layout type of this CompositionNode"
},
{
"name": "displaySettings",
"kind": "optional",
"type": "object",
"description": "Defines display settings for a CompositionNode.",
"modelRef": "#/components/schemas/CompositionDisplaySettings",
"customType": "CompositionDisplaySettings",
"schema": [
{
"name": "displayTemplate",
"kind": "required",
"type": "string",
"description": "The display template that these settings apply to.",
"minLength": 1
},
{
"name": "settings",
"kind": "optional",
"type": "map",
"nullable": true,
"description": "The display settings of this CompositionNode.",
"example": "",
"customType": "map",
"schema": []
}
]
},
{
"name": "component",
"kind": "optional",
"type": "object",
"description": "Represents a content component.",
"modelRef": "#/components/schemas/ContentComponent",
"customType": "ContentComponent",
"schema": [],
"complexType": "allOf",
"complexItems": [
{
"name": "ContentData",
"description": "",
"modelRef": "#/components/schemas/ContentData",
"schema": [
{
"name": "binding",
"kind": "optional",
"type": "object",
"description": "Associates a content item with another source content item, establishing a relationship defined by a content type binding. Used for linking managed content to external or reference content.
",
"modelRef": "#/components/schemas/ContentBinding",
"customType": "ContentBinding",
"schema": [
{
"name": "contentTypeBinding",
"kind": "optional",
"type": "string",
"description": "The binding definition key that controls how the source content item is linked and accessed."
},
{
"name": "source",
"kind": "required",
"type": "string",
"description": "The reference to the source content item that is being bound. This cannot be empty.",
"format": "uri"
}
]
},
{
"name": "properties",
"kind": "optional",
"type": "map",
"description": "Properties as they are defined by corresponding component or content type.",
"example": "",
"customType": "map",
"schema": []
}
]
},
{
"name": "object",
"description": "",
"schema": [
{
"name": "reference",
"kind": "optional",
"type": "string",
"nullable": true,
"description": "A reference to the content of this component. Cannot be assigned together with 'contentType' or 'properties'.",
"format": "uri"
},
{
"name": "contentType",
"kind": "optional",
"type": "string",
"description": "The key of the content type that this is an embedded instance of."
}
]
}
]
},
{
"name": "nodes",
"kind": "optional",
"type": "array",
"nullable": true,
"description": "The child nodes for this CompositionNode.",
"modelRef": "#/components/schemas/CompositionNode",
"customType": "CompositionNode[]",
"schema": [
{
"name": "",
"description": "",
"customType": "Circular-Reference"
}
]
}
]
},
{
"name": "media",
"kind": "optional",
"type": "object",
"description": "Represents media data attached to a content item.",
"modelRef": "#/components/schemas/MediaData",
"customType": "MediaData",
"schema": [
{
"name": "key",
"kind": "optional",
"type": "string",
"description": "The key referencing the media.",
"pattern": "^[a-f0-9]{32}\\.[a-zA-Z0-9]{1,20}$"
}
]
}
]
}
]
}
]
}
],
"complexType": "allOf",
"isExpanded": true
}
]
},
{
"statusCode": "400",
"description": "Bad Request",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "401",
"description": "Unauthorized",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "403",
"description": "Forbidden",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "409",
"description": "Conflict",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "500",
"description": "Internal Server Error",
"jsonExample": "",
"isExpanded": true
}
],
"hasXCodeSamples": false,
"examples": {
"languages": [
{
"id": "_3EHzBdC9q4a0CKIszdC4",
"language": "curl",
"label": "cURL",
"code": "curl --request POST \\\n --url /_cms/v1/content \\\n --header 'accept: application/json' \\\n --header 'content-type: application/json' \\\n --data '{\n \"contentType\": \"\",\n \"initialVersion\": {\n \"binding\": {\n \"source\": \"\"\n },\n \"displayName\": \"\",\n \"composition\": {\n \"nodeType\": \"\",\n \"displaySettings\": {\n \"displayTemplate\": \"\"\n },\n \"component\": {}\n }\n }\n }'"
},
{
"id": "pvuV864l9hVojBz6yBGiR",
"language": "javascript",
"label": "javascript",
"code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\n\nvar raw = JSON.stringify({\n \"contentType\": \"\",\n \"initialVersion\": {\n \"binding\": {\n \"source\": \"\"\n },\n \"displayName\": \"\",\n \"composition\": {\n \"nodeType\": \"\",\n \"displaySettings\": {\n \"displayTemplate\": \"\"\n },\n \"component\": {}\n }\n }\n});\n\nvar requestOptions = {\n method: 'POST',\n headers: myHeaders,\n body: raw,\n redirect: 'follow'\n};\n\nfetch(\"/_cms/v1/content\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));"
},
{
"id": "liWROhqwbUuVhTMLqqHpG",
"language": "ruby",
"label": "Ruby",
"code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"/_cms/v1/content\")\n\nhttp = Net::HTTP.new(url.host, url.port);\nrequest = Net::HTTP::Post.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\nrequest.body = JSON.dump({\n \"contentType\": \"\",\n \"initialVersion\": {\n \"binding\": {\n \"source\": \"\"\n },\n \"displayName\": \"\",\n \"composition\": {\n \"nodeType\": \"\",\n \"displaySettings\": {\n \"displayTemplate\": \"\"\n },\n \"component\": {}\n }\n }\n})\n\nresponse = http.request(request)\nputs response.read_body\n"
},
{
"id": "xTfVLfAH1_QHWk6GsmFXG",
"language": "python",
"label": "Python",
"code": "import requests\nimport json\n\nurl = \"/_cms/v1/content\"\n\npayload = json.dumps({\n \"contentType\": \"\",\n \"initialVersion\": {\n \"binding\": {\n \"source\": \"\"\n },\n \"displayName\": \"\",\n \"composition\": {\n \"nodeType\": \"\",\n \"displaySettings\": {\n \"displayTemplate\": \"\"\n },\n \"component\": {}\n }\n }\n})\nheaders = {\n 'accept': 'application/json',\n 'content-type': 'application/json'\n}\n\nresponse = requests.request(\"POST\", url, headers=headers, data=payload)\n\nprint(response.text)\n"
}
],
"selectedLanguageId": "_3EHzBdC9q4a0CKIszdC4"
},
"results": {
"languages": [
{
"id": "response-0-201",
"language": "201",
"code": "// Created\n{\n \"key\": \"\",\n \"container\": \"\",\n \"owner\": \"\",\n \"contentType\": \"\",\n \"primaryLocale\": \"\",\n \"locales\": [\n \"\"\n ],\n \"lastModified\": \"\",\n \"lastModifiedBy\": \"\",\n \"created\": \"\",\n \"createdBy\": \"\",\n \"deleted\": \"\",\n \"deletedBy\": \"\",\n \"initialVersion\": {}\n}"
},
{
"id": "response-1-400",
"language": "400",
"code": "// Bad Request\n"
},
{
"id": "response-2-401",
"language": "401",
"code": "// Unauthorized\n"
},
{
"id": "response-3-403",
"language": "403",
"code": "// Forbidden\n"
},
{
"id": "response-4-409",
"language": "409",
"code": "// Conflict\n"
},
{
"id": "response-5-500",
"language": "500",
"code": "// Internal Server Error\n"
}
],
"selectedLanguageId": "response-0-201"
}
},
"children": [
{
"text": ""
}
]
}