Create content (batch)

Create content in batch

curl --request POST \
  --url https://api.app.hrizn.io/v1/public/content/batch \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "items": [
    {
      "ideacloud_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "selected_question_ids": [
        "<string>"
      ],
      "brand_voice_id": "<string>",
      "title": "<string>",
      "language": "English",
      "content_intent": "general",
      "auto_compliance": false,
      "auto_content_tools": false,
      "content_length": 2600
    }
  ]
}
'

import requests

url = "https://api.app.hrizn.io/v1/public/content/batch"

payload = { "items": [
        {
            "ideacloud_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "selected_question_ids": ["<string>"],
            "brand_voice_id": "<string>",
            "title": "<string>",
            "language": "English",
            "content_intent": "general",
            "auto_compliance": False,
            "auto_content_tools": False,
            "content_length": 2600
        }
    ] }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    items: [
      {
        ideacloud_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        selected_question_ids: ['<string>'],
        brand_voice_id: '<string>',
        title: '<string>',
        language: 'English',
        content_intent: 'general',
        auto_compliance: false,
        auto_content_tools: false,
        content_length: 2600
      }
    ]
  })
};

fetch('https://api.app.hrizn.io/v1/public/content/batch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    items: [
      {
        ideacloud_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        selected_question_ids: ['<string>'],
        brand_voice_id: '<string>',
        title: '<string>',
        language: 'English',
        content_intent: 'general',
        auto_compliance: false,
        auto_content_tools: false,
        content_length: 2600
      }
    ]
  })
};

fetch('https://api.app.hrizn.io/v1/public/content/batch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.app.hrizn.io/v1/public/content/batch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'items' => [
        [
                'ideacloud_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
                'selected_question_ids' => [
                                '<string>'
                ],
                'brand_voice_id' => '<string>',
                'title' => '<string>',
                'language' => 'English',
                'content_intent' => 'general',
                'auto_compliance' => false,
                'auto_content_tools' => false,
                'content_length' => 2600
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "data": {
    "items": [
      {
        "id": "407d63a9-74b7-41a4-9468-09dfdb71b0da",
        "status": "generating",
        "article_type": "qa",
        "title": "2026 Chevy Silverado 3500 DRW: Deep Dive",
        "created_at": "2026-02-28T11:41:46.114731+00:00",
        "message": "Generation typically completes within a few minutes. Configure webhooks to receive real-time status notifications: https://api-docs.hrizn.io/webhooks"
      },
      {
        "id": "2e06e64c-03a2-4ec5-854e-c0f385f1fecc",
        "status": "generating",
        "article_type": "expert",
        "title": "2026 Chevy Silverado 3500 DRW: The Definitive Guide",
        "created_at": "2026-02-28T11:41:46.073345+00:00",
        "message": "Generation typically completes within a few minutes. Configure webhooks to receive real-time status notifications: https://api-docs.hrizn.io/webhooks"
      }
    ],
    "message": "Generation typically completes within a few minutes. Configure webhooks to receive real-time status notifications: https://api-docs.hrizn.io/webhooks"
  }
}

POST

content

batch

Create content in batch

curl --request POST \
  --url https://api.app.hrizn.io/v1/public/content/batch \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "items": [
    {
      "ideacloud_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "selected_question_ids": [
        "<string>"
      ],
      "brand_voice_id": "<string>",
      "title": "<string>",
      "language": "English",
      "content_intent": "general",
      "auto_compliance": false,
      "auto_content_tools": false,
      "content_length": 2600
    }
  ]
}
'

import requests

url = "https://api.app.hrizn.io/v1/public/content/batch"

payload = { "items": [
        {
            "ideacloud_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "selected_question_ids": ["<string>"],
            "brand_voice_id": "<string>",
            "title": "<string>",
            "language": "English",
            "content_intent": "general",
            "auto_compliance": False,
            "auto_content_tools": False,
            "content_length": 2600
        }
    ] }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    items: [
      {
        ideacloud_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        selected_question_ids: ['<string>'],
        brand_voice_id: '<string>',
        title: '<string>',
        language: 'English',
        content_intent: 'general',
        auto_compliance: false,
        auto_content_tools: false,
        content_length: 2600
      }
    ]
  })
};

fetch('https://api.app.hrizn.io/v1/public/content/batch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    items: [
      {
        ideacloud_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        selected_question_ids: ['<string>'],
        brand_voice_id: '<string>',
        title: '<string>',
        language: 'English',
        content_intent: 'general',
        auto_compliance: false,
        auto_content_tools: false,
        content_length: 2600
      }
    ]
  })
};

fetch('https://api.app.hrizn.io/v1/public/content/batch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.app.hrizn.io/v1/public/content/batch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'items' => [
        [
                'ideacloud_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
                'selected_question_ids' => [
                                '<string>'
                ],
                'brand_voice_id' => '<string>',
                'title' => '<string>',
                'language' => 'English',
                'content_intent' => 'general',
                'auto_compliance' => false,
                'auto_content_tools' => false,
                'content_length' => 2600
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "data": {
    "items": [
      {
        "id": "407d63a9-74b7-41a4-9468-09dfdb71b0da",
        "status": "generating",
        "article_type": "qa",
        "title": "2026 Chevy Silverado 3500 DRW: Deep Dive",
        "created_at": "2026-02-28T11:41:46.114731+00:00",
        "message": "Generation typically completes within a few minutes. Configure webhooks to receive real-time status notifications: https://api-docs.hrizn.io/webhooks"
      },
      {
        "id": "2e06e64c-03a2-4ec5-854e-c0f385f1fecc",
        "status": "generating",
        "article_type": "expert",
        "title": "2026 Chevy Silverado 3500 DRW: The Definitive Guide",
        "created_at": "2026-02-28T11:41:46.073345+00:00",
        "message": "Generation typically completes within a few minutes. Configure webhooks to receive real-time status notifications: https://api-docs.hrizn.io/webhooks"
      }
    ],
    "message": "Generation typically completes within a few minutes. Configure webhooks to receive real-time status notifications: https://api-docs.hrizn.io/webhooks"
  }
}

Submit multiple content creation requests at once. Each item is processed independently — if one item fails validation, the others still succeed. Scope required: content:write

Request body

items

array

required

Array of content creation objects (max 10). Each item accepts the same fields as Create content.

Show Item properties

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 (format: q-{timestamp}-{index}). Retrieve available IDs from Get IdeaCloud questions.

brand_voice_id

string

UUID of a brand voice.

title

string

Custom title (max 500 characters).

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"

Link distribution strategy. One of: fixed_ops, variable, general.

auto_compliance

boolean

default:"false"

Automatically run compliance 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. 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.

Example Request

curl -X POST https://api.app.hrizn.io/v1/public/content/batch \
  -H "X-API-Key: hzk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "ideacloud_id": "cec6a411-7632-498e-b2e8-afb1ea1857d7",
        "article_type": "basic",
        "language": "French",
        "auto_compliance": true,
        "auto_content_tools": true
      },
      {
        "ideacloud_id": "1d1cf94d-803e-4459-89ca-6c246aa8a4a7",
        "article_type": "qa",
        "auto_compliance": true
      },
      {
        "ideacloud_id": "30993ec0-907b-47a4-b5f1-9c1f6bd33194",
        "article_type": "basic",
        "title": "Custom Article Title"
      }
    ]
  }'

Response

Returns 202 Accepted with status for each item.

{
  "data": {
    "items": [
      {
        "id": "407d63a9-74b7-41a4-9468-09dfdb71b0da",
        "status": "generating",
        "article_type": "qa",
        "title": "2026 Chevy Silverado 3500 DRW: Deep Dive",
        "created_at": "2026-02-28T11:41:46.114731+00:00",
        "message": "Generation typically completes within a few minutes. Configure webhooks to receive real-time status notifications: https://api-docs.hrizn.io/webhooks"
      },
      {
        "id": "2e06e64c-03a2-4ec5-854e-c0f385f1fecc",
        "status": "generating",
        "article_type": "expert",
        "title": "2026 Chevy Silverado 3500 DRW: The Definitive Guide",
        "created_at": "2026-02-28T11:41:46.073345+00:00",
        "message": "Generation typically completes within a few minutes. Configure webhooks to receive real-time status notifications: https://api-docs.hrizn.io/webhooks"
      }
    ],
    "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.

Partial Failures

Each item in the batch is validated and processed independently. A single request may contain a mix of successful and failed items. Check the status field on each item in the response:

Status	Meaning
`generating`	Content creation started successfully
`failed`	Validation or processing failed — see `error` field

The batch endpoint returns 202 Accepted even if some items fail. Always check each item’s status in the response.

When to Use Batch vs. Single

Scenario	Recommended
Creating a single article with custom question selection	Create content
Generating 3+ articles programmatically	Create content (batch)
Generating 50+ articles	Batch endpoint + throttling (see Bulk Content Generation)

Using batch reduces your request count by up to 10x, leaving more rate limit headroom for other API calls. For high-volume workflows, see the Bulk Content Generation guide.

Authorizations

X-API-Key

string

header

required

Your Hrizn API key (prefix hzk_)

Body

application/json

items

object[]

required

Required array length: 1 - 10 elements

Hide child attributes

items.ideacloud_id

string<uuid>

required

items.article_type

enum<string>

required

Available options:

basic,

qa,

expert,

modellanding,

comparison,

salesevent

items.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

items.brand_voice_id

string

items.title

string

Maximum string length: 500

items.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

items.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

items.auto_compliance

boolean

default:false

items.auto_content_tools

boolean

default:false

items.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

items.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

Batch accepted

data

object

Hide child attributes

data.items

object[]

Hide child attributes

data.items.id

string<uuid>

data.items.status

string

data.items.article_type

enum<string>

Available options:

basic,

qa,

expert,

modellanding,

comparison,

salesevent

data.items.title

string

data.items.error

string

data.items.created_at

string<date-time>

data.message

string

Informational message about async processing and webhook configuration

Last modified on June 17, 2026

Create content

List content

Overview

IdeaClouds

Content Intelligence

Content

Content Types

Compliance

Content Tools

Inventory

Site

Dealership Config

Social

Webhooks

Reference

Health

IdeaClouds

Content

Compliance

Content Tools

Inventory

Site

Webhooks

Content Intelligence

Reference

Social

Request body

Example Request

Response

Partial Failures

When to Use Batch vs. Single

Authorizations

Body

Response

​Request body

​Example Request

​Response

​Partial Failures

​When to Use Batch vs. Single

Authorizations

Body

Response

Request body

Example Request

Response

Partial Failures

When to Use Batch vs. Single