ATathenahq
Content

Start Content Pipeline

Changed on

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/{content_id}/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

Request

  • Base URL
    https://api.athenahq.ai
  • Auth
    API key in header x-api-key

Request body

website_idstring required
mode'draft' | 'snipe' | 'optimize' | 'slice' 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.

titlestring

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

urlstring

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

prompt_idsstring[]

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_instructionsstring
brand_kit_idstring
sheet_idstring nullable
use_content_memoriesboolean
auto_approveboolean

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_typestring
scrape_additional_linksboolean
kb_mode'auto' | 'manual' | 'none'
selected_topic_idsstring[]
pinned_claim_idsstring[]
use_kb_internal_linksboolean
rec_idstring
rec_kind'on_page_topic' | 'on_page_snipe'
pdf_file_name_or_r2_keystring

Response

Success

content_idsstring[] required
status'generating' required
slice_titlesstring[]

Changes