Skip to main content
POST
/
content
/
{id}
/
content-tools
Generate content tools
curl --request POST \
  --url https://api.app.hrizn.io/v1/public/content/{id}/content-tools \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "tools": [
    "seo-metadata"
  ]
}
'
{
  "data": {
    "article_id": "4d42cdcf-e24f-4123-960e-6c15761fcfcf",
    "tools": [
      "seoMetadata",
      "combinedSchema",
      "facebookSnip",
      "instagramSnip",
      "twitterSnip",
      "googleBusinessSnip"
    ],
    "status": "generating",
    "message": "Generation typically completes within a few minutes. Configure webhooks to receive real-time status notifications: https://api-docs.hrizn.io/webhooks"
  }
}
Triggers generation of SEO metadata (title, description, keywords), JSON-LD schema markup, and social media snippets (Open Graph, Twitter) for completed content. Scope required: content_tools:write

Path parameters

id
string
required
UUID of a completed article.

Request body

tools
array
Specific tools to generate. Defaults to all available tools.Options: seo-metadata, schemas, social-snippets, page-slugs, post-tags, search-intent
{
  "data": {
    "article_id": "4d42cdcf-e24f-4123-960e-6c15761fcfcf",
    "tools": [
      "seoMetadata",
      "combinedSchema",
      "facebookSnip",
      "instagramSnip",
      "twitterSnip",
      "googleBusinessSnip"
    ],
    "status": "generating",
    "message": "Generation typically completes within a few minutes. Configure webhooks to receive real-time status notifications: https://api-docs.hrizn.io/webhooks"
  }
}
Content tool generation is asynchronous and typically completes within a few minutes. Configure webhooks to receive real-time content_tools.completed notifications instead of polling.
Content tools results are available as content components. Use Get content components to retrieve them.

Authorizations

X-API-Key
string
header
required

Your Hrizn API key (prefix hzk_)

Path Parameters

id
string<uuid>
required

Content ID

Body

application/json
tools
enum<string>[]
Minimum array length: 1
Available options:
seo-metadata,
schemas,
social-snippets,
page-slugs,
post-tags,
search-intent

Response

Content tool generation started

data
object
Last modified on March 1, 2026