Skip to main content
POST
Create Content Type

Path Parameters

string
required
Organization ID
string
required
Project ID

Request Body

string
required
Display name for the content type (e.g., “Article”, “BlogPost”)
string
Structured markdown description for semantic search and LLM understanding
string
required
ID of the layout component that defines the structure
array
Array of component IDs or component groups that can be used within this content type
string
required
Version of package to use for component resolution
string[]
Array of pre-built content example IDs
object
Access control settings
object
Additional type metadata

Example Request

New content types are created with draft status and null version. Use the publish endpoint to create the first published version.

Response

Returns the created ContentType object.

Error Responses

Component Not Found

Returned when a component in componentIdsAllowList does not exist:

Invalid Package Version

Returned when the layout component is not in the package version, including when that package version does not exist:

Invalid Component Allow List

A group with an empty componentIds array (here at index 1) returns the schema errors in details:

Code Examples