Skip to main content
POST
Regenerate content
Re-triggers article body generation for content that is already linked to an IdeaCloud. Use this to refresh an existing article with updated options (title, brand voice, language, or content depth) without creating a new content record. Question selection is fixed at creation time via Create content. This endpoint does not accept selected_question_ids. Scope required: content:write

Path parameters

id
string
required
UUID of the content item to regenerate.

Request body

All fields are optional. Omitted fields keep the values already stored on the content item.
brand_voice_id
string
UUID of a brand voice.
title
string
Custom content title.
language
string
Language for generated content. One of: English, Spanish, Mandarin Chinese, Japanese, Korean, Arabic, Farsi, Hebrew, French, Tagalog, Vietnamese, Portuguese, Russian.
content_depth
string
Content depth preset that drives the article body. One of concise, steady, balanced, substantial, or in-depth.
content_length
integer
deprecated
Deprecated. Article length is now driven by content_depth; this field is accepted for backward compatibility but has no effect.
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.
Returns 400 if the content item is not linked to an IdeaCloud. Content created via comparison, model landing, or sales event endpoints cannot be regenerated through this route.

Authorizations

X-API-Key
string
header
required

Your Hrizn API key (prefix hzk_)

Path Parameters

id
string<uuid>
required

Content ID

Body

application/json
brand_voice_id
string
title
string
Maximum string length: 500
language
enum<string>

Language for generated content. Overrides the language stored on the content item.

Available options:
English,
Spanish,
Mandarin Chinese,
Japanese,
Korean,
Arabic,
Farsi,
Hebrew,
French,
Tagalog,
Vietnamese,
Portuguese,
Russian
content_length
integer
deprecated

Deprecated. Article length is now driven by content_depth; this field is accepted for backward compatibility but has no effect.

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

Content depth preset that drives the article body. Defaults to balanced. Replaces the legacy content_length field.

Available options:
concise,
steady,
balanced,
substantial,
in-depth

Response

Generation started

data
object
Last modified on June 17, 2026