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

ideacloud_id
string
required
UUID of a completed IdeaCloud.
article_type
string
required
One of: basic, qa, expert, modellanding, comparison, salesevent.
selected_question_ids
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.
brand_voice_id
string
UUID of a brand voice to use for generation.
title
string
Custom content title (max 500 characters). Defaults to the IdeaCloud’s title.
language
string
default:"English"
Language for generated content. One of: English, Spanish, Mandarin Chinese, Japanese, Korean, Arabic, Farsi, Hebrew, French, Tagalog, Vietnamese, Portuguese, Russian.
content_intent
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.
auto_compliance
boolean
default:"false"
Automatically run a compliance check after generation.
auto_content_tools
boolean
default:"false"
Automatically generate SEO metadata, schemas, and social snippets.
content_depth
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.
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.

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
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
brand_voice_id
string
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

Response

Content created and generation started

data
object
Last modified on June 17, 2026