---
title: "Content action plan"
method: POST
path: "/content/action-plan"
---

# Content action plan

`POST /content/action-plan`

## Request

- Base URL: `https://www.agentseo.dev/api/v1`
- URL: `https://www.agentseo.dev/api/v1/content/action-plan`
- Auth: API key in header `x-api-key`

Turn supplied SEO opportunities into a capacity-aware content calendar and execution plan. Costs 2 credits and does not call a paid SERP provider.

## Query parameters

- `sync` boolean

## Headers

- `x-project-id` string
- `x-workflow-id` string

## Request body

- ContentActionPlanParams
  - `target` string: Optional target brand, domain, or product.
  - `goal` 'traffic_growth' | 'lead_generation' | 'refresh_decay' | 'launch_support' | 'authority_building'
  - `horizon_days` integer
  - `weekly_capacity` integer
  - `start_date` string: Optional yyyy-mm-dd planning start date.
  - `team` string[]
  - `items` object[], required
    - `title` string, required
    - `keyword` string
    - `url` string, uri
    - `source_endpoint` string
    - `opportunity_type` 'new_content' | 'refresh' | 'technical_fix' | 'internal_links' | 'schema' | 'backlink_outreach' | 'monitoring'
    - `buyer_stage` 'awareness' | 'consideration' | 'decision' | 'implementation' | 'retention'
    - `priority` 'low' | 'medium' | 'high' | 'critical'
    - `impact_score` number
    - `effort` 'small' | 'medium' | 'large'
    - `status` 'idea' | 'ready' | 'blocked' | 'in_progress'
    - `dependencies` string[]
    - `notes` string

## Response `200`

Completed content action plan workflow with agent_workflow

- ContentActionPlanResponse
  - `target` string, nullable
  - `content_action_plan` object
  - `agent_workflow` AgentWorkflow
    - `summary` string
    - `decision` 'ready' | 'act_now' | 'monitor' | 'blocker'
    - `confidence` number
    - `recommended_actions` AgentWorkflowAction[]
      - `priority` 'critical' | 'high' | 'medium' | 'low'
      - `action` string
      - `why` string
    - `evidence` AgentWorkflowEvidence[]
      - `finding` string
      - `detail` string
      - `severity` 'critical' | 'high' | 'medium' | 'low'
    - `limitations` string[]
    - `next_calls` AgentWorkflowNextCall[]
      - `endpoint` string
      - `reason` string
  - `markdown_summary` string

## Other responses

- `202`: Job queued or still processing

---

[API](https://skmtc.dev/agentseo/apis/agentseo-api.md) · [All operations](https://skmtc.dev/agentseo/apis/agentseo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentseo/apis/agentseo-api/revisions/53a62da6f92c?raw)