POST/ng-cms/content-types/{projectId}/{key}/ai-actions/{actionId}/runsmart_toyAgentic spec

Run an AI action for a content type

Executes an AI action (previously configured on the content type, see List AI actions) against a single content entry identified by entryId. The action runs using the project's default text model (CMS user setting DefaultTextModel, falls back to openai) and completes synchronously before the response is returned.

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

projectIdstring

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

Project (bucket) identifier

keystring

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

Content type ID or key

actionIdstring

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

AI action ID to run

Тело запроса

RunCmsTypeAiActionRequest

entryIdstring

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

ID of the content entry to run the action against

Ответы

202Action ran successfully against the entry.

тип: ApiResponse<bool>

successbooleanAlways true on success

resultbooleanAlways true

errorsErrorDetail[]Empty on success

400entryId missing from the request body, or the action failed for a reason other than not-found/locked (e.g. publish failed after running).

тип: ApiResponse<bool>

successbooleanAlways false

resultbooleanAlways false

errorsErrorDetail[]One error describing why the run failed

401Unauthorized.

404Either the content type does not exist for projectId/key (empty body), or the actionId/entryId does not exist (ApiResponse<bool> body with an error message).

тип: ApiResponse<bool> | empty

successbooleanAlways false (only present when action/entry not found)

errorsErrorDetail[]One error describing what wasn't found (only present when action/entry not found)

409The target entry is currently locked (e.g. being edited/processed by another operation).

тип: ApiResponse<bool>

successbooleanAlways false

errorsErrorDetail[]One error describing the lock

500Unexpected server error.

тип: ApiResponse<bool>

successbooleanAlways false

errorsErrorDetail[]Server-side errors

correlationIdstringTrace ID

messagestringError message

stackstringStack trace (non-production only)

Язык:

expand_more

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

curl --request POST \
  --url https://apis-spb.konso.io/ng-cms/content-types/{projectId}/{key}/ai-actions/{actionId}/run \
  --header 'x-api-key: <your-api-key>' \
  --header 'Content-Type: application/json' \
  --data '{"entryId":"cnt_a1b2c3d4e5f6"}'

Response Example202

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

KONSO