Skip to main content
POST
/
content
/
{id}
/
generate
Generate interactive-mode content
curl --request POST \
  --url https://api.app.hrizn.io/v1/public/content/{id}/generate \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "selected_question_ids": [
    "<string>"
  ]
}
'
{
  "data": {
    "id": "b50febaf-657a-4f6a-b951-2898aa079865",
    "status": "generating",
    "message": "Generation typically completes within a few minutes. Configure webhooks to receive real-time status notifications: https://api-docs.hrizn.io/webhooks"
  }
}
After creating content in interactive mode, submit the required inputs to trigger generation. Scope required: content:write

​
Path parameters

​
id
string
required
UUID of the content in awaiting_input status.

​
Request body

​
selected_question_ids
array
required
Array of question IDs from the IdeaCloud (format: q-{timestamp}-{index}). Retrieve available IDs from Get IdeaCloud questions.
​
brand_voice_id
string
UUID of a brand voice.
​
title
string
Custom content title.
​
language
string
default:"English"
Language for generated content. Overrides the language set during content creation. One of: English, Spanish, Mandarin Chinese, Japanese, Korean, Arabic, Farsi, Hebrew, French, Tagalog, Vietnamese, Portuguese, Russian.
​
content_length
integer
Target content length in words (200-5000). Overrides the length set during content creation.
{
  "data": {
    "id": "b50febaf-657a-4f6a-b951-2898aa079865",
    "status": "generating",
    "message": "Generation typically completes within a few minutes. Configure webhooks to receive real-time status notifications: https://api-docs.hrizn.io/webhooks"
  }
}
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_)

Path Parameters

​
id
string<uuid>
required

Content ID

Body

application/json
​
selected_question_ids
string[]
required

Question IDs from the IdeaCloud (format q-{timestamp}-{index}).

Minimum array length: 1
​
brand_voice_id
string
​
title
string
Maximum string length: 500
​
language
enum<string>
default:English

Language for generated content. Overrides the language set during content creation.

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

Target content length in words (200-5000). Overrides the length set during content creation.

Required range: 200 <= x <= 5000

Response

Generation started

​
data
object
Last modified on March 7, 2026