Create content
Generate content from a completed IdeaCloud
selected_question_ids to choose which questions to cover; otherwise the IdeaCloud’s recommended questions are used.
Scope required: content:write
Request body
basic, qa, expert, modellanding, comparison, salesevent, enhancedcontent.q-{timestamp}-{index} format). Defaults to the IdeaCloud’s recommended questions.qa and expert content unless staff was previously saved with
Update IdeaCloud settings. The
first UUID is used as the interview subject or expert.Informative, Authoritative, Persuasive,
Confident, Analytical, Empathetic, Witty, Enthusiastic,
Inspiring, Motivating, Creative. Ignored when brand_voice_id is
provided.English, Spanish, Mandarin Chinese, Japanese, Korean, Arabic, Farsi, Hebrew, French, Tagalog, Vietnamese, Portuguese, Russian.fixed_ops prioritizes service and parts links inline, appending sales links as a cross-department CTA. variable prioritizes sales and financing links inline, appending service links as a CTA. general distributes all links evenly with no filtering. One of: fixed_ops, variable, general.concise, steady, balanced, substantial, or in-depth. concise produces tight, direct prose; balanced (default) lets the topic and outline drive depth; in-depth produces thorough, exploratory prose. steady and substantial are intermediate stops between those extremes. Replaces content_length.content_depth; this field is accepted for backward compatibility but has no effect on generated output. Remove from your integration when convenient.standard or visual.output_format is visual. One of template,
custom, or user-template.visual_design_mode is user-template.element_id
UUID and a non-negative integer priority.qa and expert, either include selected_staff in this request or
persist it first with PATCH /ideaclouds/{id}/settings. There is
no PATCH /ideaclouds/{id} endpoint without the /settings
suffix.Response
Returns202 Accepted:
Authorizations
Your Hrizn API key (prefix hzk_)
Body
basic, qa, expert, modellanding, comparison, salesevent, enhancedcontent Question IDs from the IdeaCloud (UUIDs from GET /ideaclouds/{id}/questions, or legacy q-{timestamp}-{index} format). Defaults to recommended questions.
1Staff element UUIDs from GET /site/staff. Required for qa and expert content unless selected_staff was previously persisted with PATCH /ideaclouds/{id}/settings. The first UUID is used as the interview subject or expert.
1Text generation tone. Ignored when brand_voice_id is provided.
Informative, Authoritative, Persuasive, Confident, Analytical, Empathetic, Witty, Enthusiastic, Inspiring, Motivating, Creative 500Language for generated content
English, Spanish, Mandarin Chinese, Japanese, Korean, Arabic, Farsi, Hebrew, French, Tagalog, Vietnamese, Portuguese, Russian Controls which dealer links are injected inline vs. appended as a cross-department CTA. fixed_ops prioritizes service/parts links, variable prioritizes sales/financing links, general distributes all links evenly.
fixed_ops, variable, general Deprecated. Article length is now driven by content_depth; this field is accepted for backward compatibility but has no effect on the generated output. Remove from your integration when convenient.
200 <= x <= 5000Content depth preset that drives the article body. Five ordered positions: concise (tight, direct prose), steady (efficient and on-point), balanced (default; lets the topic and outline drive depth), substantial (substantively developed with concrete examples), and in-depth (thorough exploration with vivid local color). Replaces the legacy content_length field.
concise, steady, balanced, substantial, in-depth standard, visual Visual design strategy when output_format is visual.
template, custom, user-template Required when visual_design_mode is user-template.
50Response
Content created and generation started
