Skip to main content
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",
      "article_type": "basic",
      "selected_question_ids": [
        "<string>"
      ],
      "brand_voice_id": "<string>",
      "title": "<string>",
      "auto_compliance": false,
      "auto_content_tools": false,
      "mode": "simple"
    }
  ]
}
'
{
  "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.

​
Example Request

curl -X POST https://api.hrizn.io/v1/public/content/batch \
  -H "X-API-Key: hzk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "ideacloud_id": "a1b2c3d4-0001-0000-0000-000000000000",
        "article_type": "basic",
        "auto_compliance": true,
        "auto_content_tools": true
      },
      {
        "ideacloud_id": "a1b2c3d4-0002-0000-0000-000000000000",
        "article_type": "qa",
        "auto_compliance": true
      },
      {
        "ideacloud_id": "a1b2c3d4-0003-0000-0000-000000000000",
        "article_type": "expert",
        "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:
StatusMeaning
generatingContent creation started successfully
failedValidation 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

ScenarioRecommended
Generating 1-2 articles interactivelyCreate content
Generating 3+ articles programmaticallyCreate content (batch)
Generating 50+ articlesBatch 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

Response

Batch accepted

​
data
object
Last modified on March 1, 2026