Start Content Pipeline

Generate an article or content brief in AthenaHQ. Fetches source URLs, sends source material to external AI providers, and consumes content credits. Obtain user approval before calling. Does not publish to a website or CMS. For draft mode, auto_approve defaults to true; set false to generate only a brief and wait for approve_brief. Poll GET /api/v1/content//status using each returned content_ids value. Slice mode returns slice_titles and an empty content_ids array; generated items can be listed with GET /api/v1/content/items. To save an already-written article without generation or credit use, call the MCP add_content tool.

POST /api/v1/content/generate

Start Content Pipeline

cURL

curl --request POST \
  --url https://api.athenahq.ai/api/v1/content/generate \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "website_id": "<string>",
  "title": "<string>",
  "url": "<string>",
  "prompt_ids": [
    "<string>"
  ],
  "custom_instructions": "<string>",
  "brand_kit_id": "<string>",
  "sheet_id": "<string>",
  "use_content_memories": true,
  "auto_approve": true,
  "content_format_type": "<string>",
  "scrape_additional_links": true,
  "selected_topic_ids": [
    "<string>"
  ],
  "pinned_claim_ids": [
    "<string>"
  ],
  "use_kb_internal_links": true,
  "rec_id": "<string>",
  "pdf_file_name_or_r2_key": "<string>"
}
'

202

{
  "content_ids": [
    "<string>"
  ],
  "status": "generating",
  "slice_titles": [
    "<string>"
  ]
}

Authorizations

x-api-key · string · header · required

API key for authentication. You can create one here.

Body

application/json

website_id · string · required

mode · enum<string> · required

draft: generate a brief and optionally an article from tracked prompts. snipe: draft an article using a competitor URL as input. optimize: improve an existing page for AI search. slice: turn one source URL into several articles.

Available options: draft, snipe, optimize, slice

title · string

Article title. Required for draft, snipe, and optimize modes.

url · string

Source page URL. Required for snipe, optimize, and slice modes. A URL without a protocol, such as example.com/article, is accepted.

prompt_ids · string[]

Existing tracked prompt UUIDs, up to 100. Required and nonempty for draft; omit for slice. Use IDs from the website's tracked prompt list; never invent them.

custom_instructions · string

brand_kit_id · string

sheet_id · string | null

use_content_memories · boolean

auto_approve · boolean

Draft mode only. Defaults to true, which continues from brief generation to article generation. Set false to pause at generated_brief until approve_brief is called.

content_format_type · string

scrape_additional_links · boolean

kb_mode · enum<string>

Available options: auto, manual, none

selected_topic_ids · string[]

pinned_claim_ids · string[]

use_kb_internal_links · boolean

fact_review · object

A reviewed fact selection from the fact preview. When present (draft mode with the knowledge base enabled), generation uses exactly these pillars and kept facts instead of computing a selection, and pinned_claim_ids no longer influences selection. Claims without a pillar are never used: a kept id that resolves to an unfiled claim is dropped and reported in the run's selection outcome.

Show child attributes

rec_id · string

rec_kind · enum<string>

Available options: on_page_topic, on_page_snipe

pdf_file_name_or_r2_key · string

Response

202

application/json

Success

content_ids · string[] · required

status · enum<string> · required

Available options: generating

slice_titles · string[]