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": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "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.
{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "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

Response

Generation started

​
data
object
Last modified on March 1, 2026