Skip to main content
POST
/
content
Create content
curl --request POST \
  --url https://api.app.hrizn.io/v1/public/content \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "ideacloud_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "article_type": "basic"
}
'
{
  "data": {
    "id": "b70db6bb-589e-42c9-a63a-5cdc2aee0b7e",
    "status": "generating",
    "article_type": "basic",
    "title": "2026 Chevy Silverado 3500 DRW: Deep Dive",
    "created_at": "2026-02-28T11:41:21.797772+00:00",
    "message": "Generation typically completes within a few minutes. Configure webhooks to receive real-time status notifications: https://api-docs.hrizn.io/webhooks"
  }
}
Creates and generates content from a completed IdeaCloud. Supports two modes: simple (automatic) and interactive (choose questions first). 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 (format: q-{timestamp}-{index}). Defaults to the IdeaCloud’s recommended questions. Retrieve available IDs from Get IdeaCloud 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.
​
mode
string
default:"simple"
simple - Generate immediately with defaults. interactive - Return required inputs for review before generating.
​
content_length
integer
Target content length in words (200-5000). Controls the approximate length of generated content. Defaults vary by article_type: basic=1200, qa=1800, expert=2000, modellanding=2500, comparison=3500, salesevent=600.

​
Response

Simple mode returns 202 Accepted: 
{
  "data": {
    "id": "b70db6bb-589e-42c9-a63a-5cdc2aee0b7e",
    "status": "generating",
    "article_type": "basic",
    "title": "2026 Chevy Silverado 3500 DRW: Deep Dive",
    "created_at": "2026-02-28T11:41:21.797772+00:00",
    "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.
Interactive mode returns 200 OK with required inputs: 
{
  "data": {
    "id": null,
    "status": "awaiting_input",
    "ideacloud_id": "23a66cb1-f5d9-4c91-b9d2-06c8203bd251",
    "article_type": "basic",
    "required_inputs": {
      "selected_question_ids": {
        "type": "array",
        "required": true,
        "options": [
          { "id": "q-1772225333601-0", "question": "What is the maximum towing capacity of the 2026 Chevy Silverado 3500 DRW?" },
          { "id": "q-1772225333601-1", "question": "What is the maximum conventional towing capacity?" }
        ]
      },
      "brand_voice_id": { "type": "string", "required": false },
      "title": { "type": "string", "required": false }
    }
  }
}
After reviewing the inputs, submit them to Generate content to complete generation.

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,
emailtemplate
​
selected_question_ids
string[]

Question IDs from the IdeaCloud (format q-{timestamp}-{index}). 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
​
mode
enum<string>
default:simple
Available options:
simple,
interactive
​
content_length
integer

Target content length in words (200-5000). Controls how long the generated content will be. Defaults vary by article type: basic=1200, qa=1800, expert=2000, modellanding=2500, comparison=3500, salesevent=600.

Required range: 200 <= x <= 5000

Response

Interactive mode — awaiting input

​
data
object
Last modified on March 7, 2026