Create Content Plan

Generates the blog post briefs for a content plan flow.

For a flow waiting at KEYWORD_RESEARCH, this method generates the briefs and lets the flow continue to SUCCESS. Some flows advance automatically: skip this call for an existing flow already at CONTENT_PLAN or SUCCESS, unless regeneration is intended.

The flow reaches KEYWORD_RESEARCH when keyword research starts, not when it finishes. Before releasing a waiting flow, poll Get Site Keyword Research with the flow's keywordResearchId until its status is SUCCESS. Verify the returned research and flow IDs, then re-read the same flow immediately before this call. It must still be at KEYWORD_RESEARCH with the same research ID. Called while research is still running, this method fails with FLOW_NOT_READY_FOR_CONTENT_PLAN.

Called on a flow that already reached SUCCESS, this method regenerates the plan under a separate content plan flow. The response carries the new contentPlanFlowId, and you poll that ID rather than the original. The original flow keeps its own candidates.

Check success in the response as well as the HTTP status. A request that omits contentPlanFlowId reports every failure that way, with success set to false and the reason in message rather than an error. A generation failure reports that way even when you do send the ID.

Call this method once for a flow and wait for it to return. Concurrent calls for the same site can produce duplicate content plans.