plans

Generate the week's content plan

Runs the smart-tier planner over the workspace strategy, learned voice, and a summary of recent analytics (the results→plan loop), and returns a themed week — each item with a why.

post/api/v1/plans/generate

Request

Base URL: https://api.cadencz.com (the document declares no server; this is the origin it was published from)
URL: https://api.cadencz.com/api/v1/plans/generate
Auth: HTTP bearer

Request body

freshboolean

Response

Successful Response

idstring required

workspace_idstring required

week_ofstring date-time required

goalstring required

nichestring required

statusstring required

created_atstring date-time required

Example response

{
  "created_at": "2026-07-13T10:00:00Z",
  "goal": "grow",
  "id": "plan_123",
  "items": [
    {
      "angle": "reframe reliability as a principle",
      "id": "item_1",
      "platforms": [
        "x"
      ],
      "prompt": "Write about the single rule that governs our tradeoffs.",
      "scheduled_for": "2026-07-14T09:00:00Z",
      "status": "draft",
      "theme": "The one-rule philosophy",
      "why": "Tue mornings get 2x engagement for you."
    }
  ],
  "niche": "indie SaaS",
  "status": "draft",
  "week_of": "2026-07-13T00:00:00Z",
  "workspace_id": "wks_123"
}

Changes

No recorded changes to this operation across all 1 revision of this API.