POST/ng-cms/content/{projectId}/{typeKey}smart_toyAgentic spec

Create a content entry

Создает новую запись контента указанного типа и возвращает созданный объект.

Параметры запроса

projectIdstring

Обязательный

The unique identifier of the project

typeKeystring

Обязательный

The key of the content type (e.g. blog-post). Must match an existing content type in the project.

Тело запроса

CreateContentEntryRequest

fieldsobject

Обязательный

Key-value map of field data. Keys must match the field keys defined in the content type schema. Values are validated against each field's type and constraints.

langstring

Необязательный

Optional language/locale tag for the entry (e.g. "en", "ru"). Free-form string — there is no fixed list of supported languages. When omitted, the entry is stored with no language tag (null). Use together with the language filter on the list endpoint to retrieve entries for a specific language.

Ответы

201Entry created successfully in Draft status. Returns the new entry ID.

тип: ApiResponse<string>

successbooleanIndicates whether the request was successful

resultstringThe ID of the newly created content entry

errorsErrorDetail[]List of errors (empty on success)

400Validation failed — fields do not satisfy the content type schema constraints.

тип: ApiResponse<T>

isValidbooleanAlways false for validation errors

validationErrorsValidationError[]List of validation failures

namestringField that failed validation

attemptedValueobjectThe value that was submitted

messagestringHuman-readable validation message

401Unauthorized. A valid API key is required.

404Not Found. No content type exists with the given typeKey in this project.

412Precondition Failed. The project's current plan does not allow access to this resource, or payment is required to proceed.

500Unexpected server error.

тип: ApiResponse<T>

successbooleanAlways false

errorsErrorDetail[]List of server-side errors

correlationIdstringUnique ID for tracing the error

messagestringError message

stackstringStack trace (non-production only)

Язык:

expand_more

Пример запроса

curl --request POST \
  --url https://apis-spb.konso.io/ng-cms/content/{projectId}/{typeKey} \
  --header 'x-api-key: <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "fields": {
    "title": "My First Post",
    "body": "<p>Hello world</p>",
    "publishedAt": "2025-06-01T10:00:00Z"
  },
  "lang": "en"
}'

Response Example201

{
  "success": true,
  "result": "ce_x9y8z7w6v5u4",
  "errors": []
}

KONSO

Исходный код

Референсные реализации этого эндпоинта — если поведение неочевидно, проще свериться с кодом, чем гадать.

konso/konso-cms-nodejs

TypeScript

Открыть на gitverse.ruarrow_outward

konso/konso-cms-dotnet

Открыть на gitverse.ruarrow_outward

Клиентские библиотеки

Официальные SDK для вызова этого метода из вашего кода — без ручной сборки запроса.

Konso.Clients.Cms

NuGet

dotnet add package Konso.Clients.Cms

Страница пакетаarrow_outward

@konso/cms-client

npm

npm install @konso/cms-client

Страница пакетаarrow_outward