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>"
      ],
      "selected_staff": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "brand_voice_id": "<string>",
      "title": "<string>",
      "language": "English",
      "content_intent": "general",
      "auto_compliance": false,
      "auto_content_tools": false,
      "content_length": 2600,
      "output_format": "standard",
      "selected_template_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "target_geo_overrides": [
        {
          "element_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "priority": 1
        }
      ]
    }
  ]
}
'

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>"],
            "selected_staff": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
            "brand_voice_id": "<string>",
            "title": "<string>",
            "language": "English",
            "content_intent": "general",
            "auto_compliance": False,
            "auto_content_tools": False,
            "content_length": 2600,
            "output_format": "standard",
            "selected_template_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "target_geo_overrides": [
                {
                    "element_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
                    "priority": 1
                }
            ]
        }
    ] }
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>'],
        selected_staff: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
        brand_voice_id: '<string>',
        title: '<string>',
        language: 'English',
        content_intent: 'general',
        auto_compliance: false,
        auto_content_tools: false,
        content_length: 2600,
        output_format: 'standard',
        selected_template_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        target_geo_overrides: [{element_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a', priority: 1}]
      }
    ]
  })
};

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>'],
        selected_staff: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
        brand_voice_id: '<string>',
        title: '<string>',
        language: 'English',
        content_intent: 'general',
        auto_compliance: false,
        auto_content_tools: false,
        content_length: 2600,
        output_format: 'standard',
        selected_template_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        target_geo_overrides: [{element_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a', priority: 1}]
      }
    ]
  })
};

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>'
                ],
                'selected_staff' => [
                                '3c90c3cc-0d44-4b50-8888-8dd25736052a'
                ],
                'brand_voice_id' => '<string>',
                'title' => '<string>',
                'language' => 'English',
                'content_intent' => 'general',
                'auto_compliance' => false,
                'auto_content_tools' => false,
                'content_length' => 2600,
                'output_format' => 'standard',
                'selected_template_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
                'target_geo_overrides' => [
                                [
                                                                'element_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
                                                                'priority' => 1
                                ]
                ]
        ]
    ]
  ]),
  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": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "status": "<string>",
        "title": "<string>",
        "error": "<string>",
        "created_at": "2023-11-07T05:31:56Z"
      }
    ],
    "message": "<string>"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "keyword: Required",
    "details": {},
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "keyword: Required",
    "details": {},
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "keyword: Required",
    "details": {},
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "keyword: Required",
    "details": {},
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "keyword: Required",
    "details": {},
    "request_id": "<string>"
  }
}

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>"
      ],
      "selected_staff": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "brand_voice_id": "<string>",
      "title": "<string>",
      "language": "English",
      "content_intent": "general",
      "auto_compliance": false,
      "auto_content_tools": false,
      "content_length": 2600,
      "output_format": "standard",
      "selected_template_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "target_geo_overrides": [
        {
          "element_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "priority": 1
        }
      ]
    }
  ]
}
'

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>"],
            "selected_staff": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
            "brand_voice_id": "<string>",
            "title": "<string>",
            "language": "English",
            "content_intent": "general",
            "auto_compliance": False,
            "auto_content_tools": False,
            "content_length": 2600,
            "output_format": "standard",
            "selected_template_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "target_geo_overrides": [
                {
                    "element_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
                    "priority": 1
                }
            ]
        }
    ] }
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>'],
        selected_staff: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
        brand_voice_id: '<string>',
        title: '<string>',
        language: 'English',
        content_intent: 'general',
        auto_compliance: false,
        auto_content_tools: false,
        content_length: 2600,
        output_format: 'standard',
        selected_template_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        target_geo_overrides: [{element_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a', priority: 1}]
      }
    ]
  })
};

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>'],
        selected_staff: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
        brand_voice_id: '<string>',
        title: '<string>',
        language: 'English',
        content_intent: 'general',
        auto_compliance: false,
        auto_content_tools: false,
        content_length: 2600,
        output_format: 'standard',
        selected_template_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        target_geo_overrides: [{element_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a', priority: 1}]
      }
    ]
  })
};

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>'
                ],
                'selected_staff' => [
                                '3c90c3cc-0d44-4b50-8888-8dd25736052a'
                ],
                'brand_voice_id' => '<string>',
                'title' => '<string>',
                'language' => 'English',
                'content_intent' => 'general',
                'auto_compliance' => false,
                'auto_content_tools' => false,
                'content_length' => 2600,
                'output_format' => 'standard',
                'selected_template_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
                'target_geo_overrides' => [
                                [
                                                                'element_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
                                                                'priority' => 1
                                ]
                ]
        ]
    ]
  ]),
  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": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "status": "<string>",
        "title": "<string>",
        "error": "<string>",
        "created_at": "2023-11-07T05:31:56Z"
      }
    ],
    "message": "<string>"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "keyword: Required",
    "details": {},
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "keyword: Required",
    "details": {},
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "keyword: Required",
    "details": {},
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "keyword: Required",
    "details": {},
    "request_id": "<string>"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "keyword: Required",
    "details": {},
    "request_id": "<string>"
  }
}

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,

enhancedcontent

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

string<uuid>[]

Staff element UUIDs from GET /site/staff. Required for qa and expert content unless selected_staff was previously persisted with PATCH /ideaclouds/{id}/settings. The first UUID is used as the interview subject or expert.

Minimum array length: 1

items.brand_voice_id

string

items.tone

enum<string>

Text generation tone. Ignored when brand_voice_id is provided.

Available options:

Informative,

Authoritative,

Persuasive,

Confident,

Analytical,

Empathetic,

Witty,

Enthusiastic,

Inspiring,

Motivating,

Creative

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

items.output_format

enum<string>

default:standard

Available options:

standard,

visual

items.visual_design_mode

enum<string>

Visual design strategy when output_format is visual.

Available options:

template,

custom,

user-template

items.selected_template_id

string<uuid>

Required when visual_design_mode is user-template.

items.target_geo_overrides

object[]

Maximum array length: 50

Hide child attributes

items.target_geo_overrides.element_id

string<uuid>

required

items.target_geo_overrides.priority

integer

required

Required range: x >= 0

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,

enhancedcontent

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 August 3, 2026

Overview

IdeaClouds

Content Intelligence

Content

Content Types

Compliance

Content Tools

Inventory

Market

Site

Dealership Config

Social

Webhooks

Reference

Health

IdeaClouds

Content

Compliance

Content Tools

Inventory

Market

Site

Webhooks

Content Intelligence

Reference

Social

Create content in batch

Authorizations

Body

Response