> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.hrizn.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Create content
> Generate content from a completed IdeaCloud
Creates content from a completed IdeaCloud and starts generation immediately. Pass `selected_question_ids` to choose which questions to cover; otherwise the IdeaCloud's recommended questions are used.
**Scope required:** `content:write`
## Request body
UUID of a completed IdeaCloud.
One of: `basic`, `qa`, `expert`, `modellanding`, `comparison`, `salesevent`.
Array of question IDs to cover (UUIDs from [Get IdeaCloud questions](/api-reference/ideaclouds/get-questions), or legacy `q-{timestamp}-{index}` format). Defaults to the IdeaCloud's recommended questions.
UUID of a brand voice to use for generation.
Custom content title (max 500 characters). Defaults to the IdeaCloud's title.
Language for generated content. One of: `English`, `Spanish`, `Mandarin Chinese`, `Japanese`, `Korean`, `Arabic`, `Farsi`, `Hebrew`, `French`, `Tagalog`, `Vietnamese`, `Portuguese`, `Russian`.
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`.
Automatically run a compliance check after generation.
Automatically generate SEO metadata, schemas, and social snippets.
Content depth preset that drives the article body. One of `concise`, `steady`, `balanced`, `substantial`, or `in-depth`. `concise` produces tight, direct prose; `balanced` (default) lets the topic and outline drive depth; `in-depth` produces thorough, exploratory prose. `steady` and `substantial` are intermediate stops between those extremes. Replaces `content_length`.
**Deprecated.** Article length is now driven by `content_depth`; this field is accepted for backward compatibility but has no effect on generated output. Remove from your integration when convenient.
## Response
Returns `202 Accepted`:
```json 202 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"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](/webhooks) to receive real-time `content.completed` and `content.failed` notifications instead of polling.
## OpenAPI
````yaml POST /content
openapi: 3.1.0
info:
title: Hrizn Public API
version: 1.2.0
description: >
The Hrizn Public API allows partners to programmatically create content,
manage inventory descriptions, and integrate with the Hrizn platform.
All endpoints are prefixed with `/public` and require an API key passed via
the `X-API-Key` header (except the health check).
contact:
email: support@hrizn.io
servers:
- url: https://api.app.hrizn.io/v1/public
description: Production
security:
- apiKeyAuth: []
tags:
- name: IdeaClouds
description: Create and manage AI-powered keyword research
- name: Content Intelligence
description: AI-powered content gap analysis and recommendations
- name: Content
description: Generate content from IdeaClouds
- name: Compliance
description: Run OEM compliance checks on content
- name: Content Tools
description: Generate SEO metadata, schemas, and social snippets
- name: Inventory
description: Access vehicle data and AI descriptions
- name: Site
description: View dealership details and configuration
- name: Webhooks
description: Manage webhook subscriptions for real-time events
- name: Reference
description: Look up available types, scopes, and events
- name: Social
description: >-
Zernio-backed social posting and reviews across all connected platforms
(X, Facebook, Instagram, LinkedIn, Google Business Profile)
- name: Health
description: Health check (no authentication)
paths:
/content:
post:
tags:
- Content
summary: Create content
description: >-
Creates new content from a completed IdeaCloud and starts generation
immediately.
operationId: createContent
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateArticleInput'
responses:
'202':
description: Content created and generation started
content:
application/json:
schema:
$ref: '#/components/schemas/ArticleCreatedResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
components:
schemas:
CreateArticleInput:
type: object
required:
- ideacloud_id
- article_type
properties:
ideacloud_id:
type: string
format: uuid
article_type:
$ref: '#/components/schemas/ArticleType'
selected_question_ids:
type: array
description: >
Question IDs from the IdeaCloud (UUIDs from GET
/ideaclouds/{id}/questions, or legacy `q-{timestamp}-{index}`
format). Defaults to recommended questions.
items:
type: string
minItems: 1
brand_voice_id:
type: string
title:
type: string
maxLength: 500
language:
type: string
enum:
- English
- Spanish
- Mandarin Chinese
- Japanese
- Korean
- Arabic
- Farsi
- Hebrew
- French
- Tagalog
- Vietnamese
- Portuguese
- Russian
default: English
description: Language for generated content
content_intent:
type: string
enum:
- fixed_ops
- variable
- general
default: general
description: >-
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.
auto_compliance:
type: boolean
default: false
auto_content_tools:
type: boolean
default: false
content_length:
type: integer
minimum: 200
maximum: 5000
deprecated: true
description: >
**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.
content_depth:
type: string
enum:
- concise
- steady
- balanced
- substantial
- in-depth
description: >
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.
ArticleCreatedResponse:
type: object
properties:
data:
type: object
properties:
id:
type: string
format: uuid
status:
$ref: '#/components/schemas/ContentStatus'
article_type:
$ref: '#/components/schemas/ArticleType'
title:
type: string
created_at:
type: string
format: date-time
message:
type: string
description: >-
Informational message about async processing and webhook
configuration
ArticleType:
type: string
enum:
- basic
- qa
- expert
- modellanding
- comparison
- salesevent
ContentStatus:
type: string
enum:
- generating
- complete
- failed
description: Content generation status
ErrorResponse:
type: object
properties:
error:
type: object
properties:
code:
type: string
example: validation_error
message:
type: string
example: 'keyword: Required'
details:
type: object
request_id:
type: string
responses:
BadRequest:
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Unauthorized:
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Forbidden:
description: API key lacks required scope
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
NotFound:
description: Resource not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
RateLimited:
description: Rate limit exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
InternalError:
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Your Hrizn API key (prefix hzk_)
````