---
title: "Start Content Pipeline"
method: POST
path: "/api/v1/content/generate"
tags: ["Content"]
---

# Start Content Pipeline

`POST /api/v1/content/generate`

Start the content pipeline in one of four modes — draft (write new content from promptIds), snipe (outrank a competitor url), optimize (improve an existing url for AI search), slice (split one url into several articles). Required fields by mode: draft needs promptIds (resolve real prompt ids first — via prompts.selectForDraft in chat, or get_prompts / GET /v1/prompts over MCP and the API; never invent ids) AND title; snipe needs url AND title; optimize needs url AND title; slice needs url (and must NOT include promptIds). Returns durable contentIds (job handles); poll get_content_status (content.pipeline.status) per id. Credit op; requires approval.

## Request body

- object
  - `website_id` string, required
  - `mode` 'draft' | 'snipe' | 'optimize' | 'slice', required
  - `title` string
  - `url` string
  - `prompt_ids` string[]
  - `custom_instructions` string
  - `brand_kit_id` string
  - `sheet_id` string, nullable
  - `use_content_memories` boolean
  - `auto_approve` boolean
  - `content_format_type` string
  - `scrape_additional_links` boolean
  - `kb_mode` 'auto' | 'manual' | 'none'
  - `selected_topic_ids` string[]
  - `pinned_claim_ids` string[]
  - `use_kb_internal_links` boolean
  - `rec_id` string
  - `rec_kind` 'on_page_topic' | 'on_page_snipe'
  - `pdf_file_name_or_r2_key` string

## Response `202`

Success

- object
  - `content_ids` string[], required
  - `status` 'generating', required
  - `slice_titles` string[]

## Other responses

- `400` — Bad Request — validation failed
- `401` — Unauthenticated
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `429` — Rate Limited
- `500` — Internal Error

---

[API](https://skmtc.net/athenahq/apis/athenahq-api.md) · [All operations](https://skmtc.net/athenahq/apis/athenahq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/athenahq/athenahq-api/versions/6c5d71622cb9/schema)