Skip to main content
POST
Create content
Creates content from a completed IdeaCloud and starts generation immediately. Pass selected_question_ids to choose which questions to cover; otherwise the IdeaCloud’s recommended questions are used. Scope required: content:write

Request body

string
required
UUID of a completed IdeaCloud.
string
required
One of: basic, qa, expert, modellanding, comparison, salesevent, enhancedcontent.
array
Array of question IDs to cover (UUIDs from Get IdeaCloud questions, or legacy q-{timestamp}-{index} format). Defaults to the IdeaCloud’s recommended questions.
array
Staff element UUIDs from Get site staff. Required for qa and expert content unless staff was previously saved with Update IdeaCloud settings. The first UUID is used as the interview subject or expert.
string
UUID of a brand voice to use for generation.
string
Text generation tone. One of: Informative, Authoritative, Persuasive, Confident, Analytical, Empathetic, Witty, Enthusiastic, Inspiring, Motivating, Creative. Ignored when brand_voice_id is provided.
string
Custom content title (max 500 characters). Defaults to the IdeaCloud’s title.
string
default:"English"
Language for generated content. One of: English, Spanish, Mandarin Chinese, Japanese, Korean, Arabic, Farsi, Hebrew, French, Tagalog, Vietnamese, Portuguese, Russian.
string
default:"general"
Controls how dealer links are distributed in the generated content. 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.
boolean
default:"false"
Automatically run a compliance check after generation.
boolean
default:"false"
Automatically generate SEO metadata, schemas, and social snippets.
string
default:"balanced"
Content depth preset that drives the article body. One of 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.
integer
deprecated
Deprecated. Article length is now driven by content_depth; this field is accepted for backward compatibility but has no effect on generated output. Remove from your integration when convenient.
string
default:"standard"
One of standard or visual.
string
Visual design strategy when output_format is visual. One of template, custom, or user-template.
string
Template UUID. Required when visual_design_mode is user-template.
array
Up to 50 target geography overrides. Each item contains an element_id UUID and a non-negative integer priority.
For 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

Returns 202 Accepted:
Content generation is asynchronous and typically completes within a few minutes. Configure webhooks to receive real-time content.completed and content.failed notifications instead of polling.

Authorizations

X-API-Key
string
header
required

Your Hrizn API key (prefix hzk_)

Body

application/json
ideacloud_id
string<uuid>
required
article_type
enum<string>
required
Available options:
basic,
qa,
expert,
modellanding,
comparison,
salesevent,
enhancedcontent
selected_question_ids
string[]

Question IDs from the IdeaCloud (UUIDs from GET /ideaclouds/{id}/questions, or legacy q-{timestamp}-{index} format). Defaults to recommended questions.

Minimum array length: 1
selected_staff
string<uuid>[]

Staff 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.

Minimum array length: 1
brand_voice_id
string
tone
enum<string>

Text generation tone. Ignored when brand_voice_id is provided.

Available options:
Informative,
Authoritative,
Persuasive,
Confident,
Analytical,
Empathetic,
Witty,
Enthusiastic,
Inspiring,
Motivating,
Creative
title
string
Maximum string length: 500
language
enum<string>
default:English

Language for generated content

Available options:
English,
Spanish,
Mandarin Chinese,
Japanese,
Korean,
Arabic,
Farsi,
Hebrew,
French,
Tagalog,
Vietnamese,
Portuguese,
Russian
content_intent
enum<string>
default:general

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.

Available options:
fixed_ops,
variable,
general
auto_compliance
boolean
default:false
auto_content_tools
boolean
default:false
content_length
integer
deprecated

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.

Required range: 200 <= x <= 5000
content_depth
enum<string>

Content 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.

Available options:
concise,
steady,
balanced,
substantial,
in-depth
output_format
enum<string>
default:standard
Available options:
standard,
visual
visual_design_mode
enum<string>

Visual design strategy when output_format is visual.

Available options:
template,
custom,
user-template
selected_template_id
string<uuid>

Required when visual_design_mode is user-template.

target_geo_overrides
object[]
Maximum array length: 50

Response

Content created and generation started

data
object
Last modified on August 3, 2026